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. A 400 error response with a code field set to "spam_error" may be returned if any of the provided event content appears to contain spam. 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. A 400 error response with a code field set to "spam_error" may be returned if any of the provided event content appears to contain spam. 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.

text_format

Format of the description in the response, "html" or "plain". Defaults to "html"

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