Extend your community

Event Create

POST /2/event
  • json
  • xml
Host: api.meetup.com
  • basic
api version 2

Request Parameters

All required parameters must be supplied. This method requires parameters encoded in application/x-www-form-urlencoded format as an HTTP POST.

Survey questions may be submitted in the format "question_{index}=questiontext" where "index" is an integer representing the order the questions should be presented in. e.g. question_0=question1&question_1=question2.

Organizers of the hosting group may optionally save this event as a draft by setting "publish_status" to "draft". Drafts are then discoverable using the /2/events API setting the "status" request parameter to "draft"

description
Longer description of the event, in HTML. May not be longer than 50000 characters.
duration
Event duration in milliseconds. When not specified, a default of 3 hours may be assumed by applications. To clear event duration, set this to 0
email_reminders
Limited to organizers and event hosts, if false, disables event reminders
group_id
Group hosting the event
group_urlname
URL name of the Group hosting the event
guest_limit
Number of guests members may include in their RSVP, 0 or more
host_instructions
optional set of instructions to provide to hosts, only used when hosts are provided
hosts
Up to 5 comma-separated valid member ids to be hosts for the event. If hosts is not provided, the authorized member is the default host
how_to_find_us
The information provided by the event host for "How will members find you there?". Visible when location is visible to the authenticated member
name
Name of the event. May not be longer than 80 characters.
publish_status
If you are an organizer of the group, you may set this to "draft" to save the event as a draft. Doing so will require a status=draft filter on /2/event queries.
question_{index}
Those with permission may include up to 6 survey questions for the event with each being up to 250 characters. See the parameter notes section for more information
rsvp_alerts
Limited to organizers and event hosts, if false, disables member RSVP alerts
rsvp_close
Users with permission may set the RSVP close time for the event. The time may be specified in milliseconds since the epoch, or relative to the current time in the d/w/m format.
rsvp_limit
Total number of RSVPs available for the event
rsvp_open
Users with permission may set the RSVP open time for the event. The time may be specified in milliseconds since the epoch, or relative to the current time in the d/w/m format.
simple_html_description
Description of the event, in simple HTML format. This value is translated to HTML to update the description. May not be longer than 50000 characters.
time
Event start time in milliseconds since the epoch, or relative to the current time in the d/w/m format.
venue_id
Numeric identifier of a venue
venue_visibility
Controls the visibility of the event venue for non members of the hosting group. May be one of "public" or "members"
waitlisting
Waiting list status may be one of: auto, manual, off
why
We should do this because... May not be longer than 250 characters.

Response

If successful, this method returns an HTTP 201 Created response with a Location header containing the Event Get method for this event. 401 Unauthorized is returned if the currently authenticated member can not create meetups in the specified group. The content body is the same as that returned by Event Get.

Event Edit

POST /2/event/:id
  • json
  • xml
Host: api.meetup.com
  • basic
api version 2

Update an existing Meetup

Request Parameters

All parameters are optional. This method requires an HTTP POST.

If a lat & lon are provided, the event's venue will be updated accordingly.

Survey questions may be submitted in the format "question_{index}=questiontext" where "index" is an integer representing the order the questions should be presented in. e.g. question_0=question1&question_1=question2.

To view existing survey questions supply the request parameter fields=survey_questions with the Event Get To edit questions you may submit questions in the format "question_edit_{id}=updatedquestion" where id is the id of the question. To clear an existing question for the event survey, just submit question_edit_{id} with an empty value.

Organizers may publish a draft event by posting with the "publish_status" request parameter set to "published". Organizers and hosts of the event may also optionally announce an unannounced event by posting with the "announce" request parameter set to "true"

announce
Organizers and hosts may set this to true to announce a Meetup.
announce_message
Organizers and hosts may provide an optional message in this field when announcing a Meetup. May not be longer than 500 characters.
description
Longer description of the event, in HTML. May not be longer than 50000 characters.
duration
Event duration in milliseconds. When not specified, a default of 3 hours may be assumed by applications. To clear event duration, set this to 0
email_reminders
Limited to organizers and event hosts, if false, disables event reminders
group_id
Group to hold the event
guest_limit
number of guests members may include in their RSVP, 0 or more
host_instructions
optional set of instructions to provide to hosts, only used when hosts are provided
hosts
Up to 5 valid member ids to be hosts for the event.
how_to_find_us
The information provided by the event host for "How will members find you there?". Visible when location is visible to the authenticated member
lat,lon
Updates to the venue's latitude and longitude. When present, both must be provided
name
Event name. May not be longer than 80 characters.
publish_status
If you are an organizer of the group, you may set this to "draft" or "published". Setting state to "draft" will require a status=draft filter on /2/event queries.
question_edit_{id}
Those with permission may include up to 6 survey questions with each being up to 250 characters, including new questions. To delete a question submit this parameter with an empty value
question_{index}
Those with permission may include up to 6 survey questions with each being up to 250 characters, including edited questions, for the event. See the parameter notes section for more information
rsvp_alerts
Limited to organizers and event hosts, if false, disables member RSVP alerts
rsvp_close
Users with permission may set the RSVP close time for the event. The time may be specified in milliseconds since the epoch, or relative to the current time in the d/w/m format. To unset rsvp_close, set this to 0
rsvp_limit
Total number of RSVPs available for the event. To remove this limit, set this to 0
rsvp_open
Users with permission may set the RSVP open time for the event. The time may be specified in milliseconds since the epoch, or relative to the current time in the d/w/m format.
simple_html_description
Description of the event, in simple HTML format. This value is translated to HTML to update the description. May not be longer than 50000 characters.
time
event start time in milliseconds since the epoch, or relative to the current time in the d/w/m format.
venue_id
Numeric identifier of a venue. To unset the event's venue, set this to 0
venue_visibility
Controls the visibility of venue. May be one of "public" or "members"
waitlisting
Waiting list status may be one of: auto, manual, off
why
We should do this because... May not be longer than 250 characters.

Response

If successful, this method returns an HTTP 200 OK response. 401 Unauthorized is returned if the currently authenticated member can not edit the specified Meetup. The content body is the same as that returned by Event Get.

Event Get

GET /2/event/:id
  • json
  • xml
Host: api.meetup.com
  • basic
api version 2

Retrieve a single meetup

Try it in the console

Request Parameters

Only authorization parameters are needed. Some groups, while remaining private, still wish to show some information about their events. You can include these events in results using the limited_events request parameter.

fields
Request that additional fields (separated by commas) be included in the output.
limited_events
Include limited event information for private groups that wish to expose only a small amount of information about their events. This includes just: id, name, utc_offset, time, duration, yes_rsvp_count, waitlist_count, group, visibility, timezone. Value must be true or false.

Response

announced
Organizers and hosts can see if the event was announced
announced_at
Organizers and hosts can see when the event as announced in milliseconds since the epoch
comment_count
Returned when fields request parameter contains "comment_count" and represents number of comments posted to the event
created
UTC creation time of the event, in milliseconds since the epoch
description
Description of the event.
distance
Distance in miles from the search location, if one was specified
duration
Event duration in milliseconds, if an end time is specified by the organizer. When not present, a default of 3 hours may be assumed by applications.
email_reminders
Returned when fields request parameter contains "email_reminders" and is limited to organizers and event hosts, if false, event reminders are disabled
event_hosts
List of members hosting the event, only returned if requested in the fields parameter.
member_id
The host's member id
member_name
The host's member name
event_url
URL of the event's page on meetup.com
featured
Returned when fields request parameter contains "featured" and returns "true" if the event is featured and "false" otherwise
fee
Fee info returned when payment is defined
accepts
Accepted method of payment. Can be one of "paypal", "amazon", or "cash"
amount
Amount of the fee
currency
Currency accepted for fee
description
Fee description, typically "per person"
label
Fee label, typically "Price"
required
"1" if payment is required to RSVP, "0" otherwise
group
Group that is hosting the event
approved
Returned when fields request parameter contains "group_approved". True if this group has been approved. New groups are generally approved (or removed) soon after creation.
category
Optional field. Category of this group
id
Numeric identifier of the category
name
Display name of the category
shortname
String identifier of the category
created
Date and time that the group was founded, in milliseconds since the epoch
group_lat
Approximate group latitude
group_lon
Approximate group longitude
group_photo
Returned when fields request parameter contains "group_photo" and represents photo for the group hosting the event
highres_link
URL for the photo at its maximum size
photo_id
-
photo_link
URL for a standard size of the photo
thumb_link
URL for a thumbnail of the photo
id
Group id
join_mode
"open", "approval", or "closed"
membership_dues
Returned when fields request parameter contains "group_membership_dues"
currency
Currency fee is declared as
fee
Numeric fee value
fee_desc
Description of fee
methods
Array of acceptable payment methods. May be one or more of "amazon_payments", "paypal", "credit_card" or "other"
reasons
Array of reasons types in the following values compensate_organizer, cover_costs, encourage_engagement, improve_meetups, other, provide_supplies, reserve_fund
reasons_other
An additional reason if specified.
refund_policy
Array of payment refund policies. May be one or more of "none", "member_leaves", "group_closes", "member_banned", or "custom"
required
"2" if dues are required to join, "1" if dues are required to RSVP, "0" otherwise
self_payment_required
Returns true if the authorized user is prevented from participating in the group until a payment is made
trial_days
When present, returns the number of days the group is offering a free trial period for to new members. When not present, this indicates that the group does not offer a trial membership period
name
Group name
self
Returned when fields request parameter contains 'self_membership_dues' or 'group_status'
membership_dues
The authenticated member's group dues in the form returned by group endpoints
status
The member's status. May be one of 'active' or 'pending'
topics
Optional field. Topics related to this group
id
Topic ID
name
Topic name
urlkey
Unique keyword used to identify this topic
urlname
Group URL name
who
What the group calls its members
headcount
The number of members in attendance according to the attendance taker. This may be 0 if attendance has not yet been taken
how_to_find_us
The information provided by the event host for "How will members find you there?". Visible when location is visible to the authenticated member
id
The event id. May be numeric or alphanumeric, always served as a string
is_simplehtml
Optional field, "true" when the event has been saved in a simplified HTML format, "false" otherwise.
maybe_rsvp_count
Number of maybe RSVPs including guests
name
The name of the event
photo_album_id
Returned when fields request parameter contains "photo_album_id" and returns the ID of the photo album for this event, if one exists
photo_count
Returned when fields request parameter contains "photo_count" and represents number of photos posted to the event
photo_url
URL of the event photo, if one exists
publish_status
"published" or "draft" only visible to organizers
rating
Only past events have this field, an aggregate of anonymous ratings
average
Average of collected ratings
count
Number of ratings been collected
rsvp_alerts
Returned when fields request parameter contains "rsvp_alerts" and is limited to organizers and event hosts, if false, member RSVP alerts are disabled
rsvp_limit
The number of "yes" RSVPs an event can have before members will be added to the waiting list
rsvp_rules
Conditions set by the organizer, only returned if requested in the fields parameter.
close_time
UTC time that RSVPs will no longer be accepted, though organizers may close RSVPs earlier
closed
Flag indicating that RSVPing is closed for the event. 1 is true 0 is false
guest_limit
Number of guests members may include in their RSVP, 0 or more
open_time
UTC time that members may begin to RSVP
refund_policy
The organizer-defined terms for refunds. If this is defined, you must provide the authenticated member a way to access this information before they can RSVP. They will need to agree to these terms before they RSVP
days
if member_cancellation is present, it's relative to this many days before the event
notes
additional refund policy notes
policies
list of one or more of the following. 'no_refunds' if the organizer will not issue refunds', 'member_cancellation' if the organizer offers a refund for member cancellation, 'event_cancellation' if the organizer offers a refund if the event is canceled, 'event_rescheduled' if the organizer offers a refund when the event is rescheduled
waitlisting
Wait list handling when RSVP limit is reached. Value may be one of "auto", "manual" or "off"
rsvpable
Indicates if the currently authenticated member can RSVP or not, only returned if requested in the fields parameter
self
Returned when fields request parameter contains "self" and represents details particular to the authorized user, only present if requested and user is a member of the hosting group
actions
list of actions the current user may perform, potentially: "announce" to announce the event to the group's members, "attendance" to view or take attendance for the event, "payments" to mark members as paid if the event is a paid event, "publish" to publish a draft event, "edit" to edit the event information, "edit_hosts" to edit the hosts for the event, "delete" to delete the event, "rsvp" to RSVP yes or no to the event, or "wait" to get on the waiting list (using the same RSVP methods). For events without a waitlist, you may see either "watch" or "unwatch" to watch for opening spots for the event when the event is full. If an organizer requires membership dues to rsvp and the authorized member has not paid theirs, "dues" will be included
pay_status
The authenticated member's payment status. This may be one of 'none', 'paid', 'partially_paid', 'payment_pending', 'echeck_pending', 'refund_pending', 'partially_refunded', 'refunded'.
rated
Boolean indicator of whether the current member rated the event or not
role
The authenticated member's role in within the group, if any. This may be one of: Organizer, Assistant Organizer, Event Organizer, etc.
rsvp
Member's RSVP, if any
answers
List of answers to event survey questions asked when the member RSVP'd in the order asked, only available to organizers and assistant organizers. By default, this field returns a list of strings answers. You can request more structured answer info including the time the answer was updated, by setting fields=rsvp_answer_info in the request. The structured format for answers is defined in Rsvp API's response
guests
number of guests
response
"yes", "no", or "waitlist"
watching
For events without waitlist you may check your watchlist status with this property. Values may either be true of false.
short_link
Returned when fields request parameter contains "short_link". If hosting group is private, this will return the group's short_link
simple_html_description
Optional field, description of the event in simple HTML format.
status
"cancelled", "upcoming", "past", "proposed", "suggested" or "draft"
survey_questions
Returned when fields request parameter contains "survey_questions" for events with surveys
id
Question identifier
question
Question text
required
Flag indicating if a response to this question is required to RSVP. Currently always false.
time
UTC start time of the event, in milliseconds since the epoch
timezone
Returned when fields request parameter contains "timezone". This represents the universal timezone identifier for the host group
trending_rank
Indicates the trending rank within the current result set. The best rank is zero, increasing rank values are less "trending". This value is only returned if requested in the fields parameter
updated
UTC last modified time of the event, in milliseconds since the epoch
utc_offset
The local offset from UTC time, in milliseconds
venue
Venue, if selected and not hidden
address_1
Line 1 of venue address
address_2
Line 2 of venue address
address_3
Line 3 of venue address
city, state, country
City, Country and if in US state of venue
id
Venue id
lat, lon
Geographic coordinates of venue
name
Venue name
phone
Phone number of venue
repinned
true if the editor of the event altered the original venues pin location, false otherwise
zip
ZIP code if, venue is in US or Canada
venue_visibility
Set to "members" or "public". The "venue" element will not be present if the visibility is "members" and the current authenticated user is not a member of the group hosting the event. This value is only returned if requested in the fields parameter
visibility
Event visibility: "public", "members" or "public_limited". Events in private groups that do not expose limited information are visible only to that group's members and should not be made public.
why
We should do this because...
yes_rsvp_count
Number of yes RSVPs including guests

Event Delete

DELETE /2/event/:id
  • json
  • xml
Host: api.meetup.com
  • basic
api version 2

Deletes a specified meetup

Request Parameters

Only authorization parameters are needed.

Response

Returns an HTTP 200 response if delete was successful, 401 if unauthorized.

API methods

everywhere seed events