The Wayback Machine - https://web-wp.archive.org/web/20140924045939/http://www.meetup.com:80/meetup_api/docs/:urlname/topics/

Extend your community

Group Topics Add

POST /:urlname/topics
  • json
Host: api.meetup.com
  • group_edit
api version 3

Associates topics with a given Meetup Group. Limited to organizers of the group. OAuth authenticated requests require an additional group_edit permission.

Request Parameters

A group can have at most 15 topics

topic_id
Comma-delimited list of topic ids to associate with group

Response

A successful response will include a representation of the group topics were added to

category
The primary category of the group, if the group has one
id
Numeric category id
name
Display name of the category
shortname
String identifier of the category
city
City of the group
country
Country of the group
created
Time the group was created in milliseconds since the epoch
description
Short description of group
ga_code
Optional field return the Google Analytics code for the group. Only members that can edit group settings can see this
group_photo
Group photo
highres_link
Link for full sized photo
id
Numeric photo ID
photo_link
Link for standard sized photo
thumb_link
Link for thumbnail sized photo
id
Numeric group ID
is_simplehtml
Optional field, 'true' when the group description has been saved in a simplified HTML format, 'false' otherwise.
join_info
Optional field, lists any questions requested when joining and required fields
intro_required
true if required, false otherwise
photo_required
true if required, false otherwise
questions
List of questions asked by organizer
id
Unique identifier for the question
question
The text of the question
questions_req
true if required, false otherwise
join_mode
Who can join this group and how. One of approval, closed, open
lat
Latitude
link
Link to group on meetup.com
list_addr
Optional field returning list address prefix. List mail will be {list_addr}-list@meetup.com. Announce email will be {list_addr}-announce@meetup.com. You must be a member of the group to see this
list_mode
Optional fields parameter representing the policy for who can post the group mailing list. One of moderated, off, open, orgs_only
lon
Longitude
members
Number of Meetup members in this group
membership_dues
Optional field, returns membership dues for group if any
currency
Currency fee is declared as
fee
Numeric fee value
fee_desc
Description of fee
methods
Methods of payments
amazon_payments
Boolean indicator that Amazon Payments are accepted
credit_card
Boolean indicator that credit cards are accepted
other
Boolean indicator that other forms of payment are accepted
paypal
Boolean indicator that Paypal payments are accepted
reasons
Array of reasons containing one or more of 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
Conditions for refunds
custom
Boolean indicator of a custom refund policy
group_closes
refund applies when the group closes
member_banned
refund applies when the member is banned
member_leaves
refund applies when member leaves the group
none
indicates there is no refund policy
required
true if dues are required
required_to
If the dues are required this indicates what they are required for. May be one of 'join' or 'rsvp'
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
Name of the group
next_event
The next upcoming event, if the group has one
id
Alphanumeric event ID
name
Name of event
time
UTC start time of the event, in milliseconds since the epoch
organizer
Group's primary organizer
bio
Bio of member
id
Numeric member ID
name
Name of member
photos
A small set of photos from the group
highres_link
Link for full sized photo
id
Numeric photo ID
photo_link
Link for standard sized photo
thumb_link
Link for thumbnail sized photo
self
Optional field, contains details specific to the authorized user if an active member of this group
actions
list of actions the current user may perform, potentially "event_create": the ability to create new events, "event_draft": the ability to save new events as drafts, "role_assign": the ability to assign member roles, or "edit": the ability to edit group settings
membership_dues
Member's membership dues if the group has membership dues
cancelled
For groups with recurring billing periods, this Boolean field indicates that membership dues were cancelled
exempt
For groups with recurring billing periods, this Boolean field indicates that the member is exempt from payment.
paid_until
For groups with recurring billing periods, this returns the time in milliseconds since the epoch that the member's next payment is due
period_status
For groups with recurring billing periods, this returns one of the following values grace paid pending unpaid
total_amount
Total amount paid
transaction_time
Time the transaction was made in milliseconds since the epoch
trial
If the group offers a trial membership, this indicates information for unpaid members.
role
Member's role in group, if any: Organizer, Assistant Organizer, Event Organizer, etc.
status
Optional fields property returned when 'self_status' is provided. Indicates the authorized user's membership with this group. Value may be one of pending, pending_payment, active, blocked or none
visited
Member's last visit to the group site, in milliseconds since the epoch
short_link
Optional field, a shorted URL for the group
similar_groups
Optional fields parameter. Returns up to 5 groups similar to this groups
id
Id of the group
join_mode
Who can join this group and how. One of approval, closed, open
lat
Latitude
lon
Longitude
name
Name of the group
photos
Optional fields parameter. A small set of photos from the group
highres_link
Link for full sized photo
id
Numeric photo ID
photo_link
Link for standard sized photo
thumb_link
Link for thumbnail sized photo
urlname
Urlname used to identify the group on meetup.com
who
What this group calls it's members
simple_html_description
Description of the group, in simple HTML source format. If this group's description was saved in simple HTML format, the description field will be an HTML translation of this source
state
State of the group, if in US or Canada
timezone
This represents the universal timezone identifier for the group
topics
Optional fields parameter. Returns the group's topics
id
Numeric topic id
lang
Language topic originates from
name
Display name of the topic
urlkey
The unique keyword used to identify this topic
urlname
Urlname used to identify the group on meetup.com
visibility
Who can see this group. One of members, public or public_limited
welcome_message
Optional fields parameter. Returns the Group's default welcome message if the authenticated member is the organizer of the group
who
What the group calls its members

Group Topics Remove

DELETE /:urlname/topics
  • json
Host: api.meetup.com
  • group_edit
api version 3

Disassociates topics with a given Meetup Group. Limited to organizers of the group. OAuth authenticated requests require an additional group_edit permission.

Request Parameters

Groups must have at one topic. Attempts to remove all topics will result in a failed request

topic_id
Comma-delimited list of topic ids to disassociate with group

Response

A successful response will include a representation of the group topics were removed from

category
The primary category of the group, if the group has one
id
Numeric category id
name
Display name of the category
shortname
String identifier of the category
city
City of the group
country
Country of the group
created
Time the group was created in milliseconds since the epoch
description
Short description of group
ga_code
Optional field return the Google Analytics code for the group. Only members that can edit group settings can see this
group_photo
Group photo
highres_link
Link for full sized photo
id
Numeric photo ID
photo_link
Link for standard sized photo
thumb_link
Link for thumbnail sized photo
id
Numeric group ID
is_simplehtml
Optional field, 'true' when the group description has been saved in a simplified HTML format, 'false' otherwise.
join_info
Optional field, lists any questions requested when joining and required fields
intro_required
true if required, false otherwise
photo_required
true if required, false otherwise
questions
List of questions asked by organizer
id
Unique identifier for the question
question
The text of the question
questions_req
true if required, false otherwise
join_mode
Who can join this group and how. One of approval, closed, open
lat
Latitude
link
Link to group on meetup.com
list_addr
Optional field returning list address prefix. List mail will be {list_addr}-list@meetup.com. Announce email will be {list_addr}-announce@meetup.com. You must be a member of the group to see this
list_mode
Optional fields parameter representing the policy for who can post the group mailing list. One of moderated, off, open, orgs_only
lon
Longitude
members
Number of Meetup members in this group
membership_dues
Optional field, returns membership dues for group if any
currency
Currency fee is declared as
fee
Numeric fee value
fee_desc
Description of fee
methods
Methods of payments
amazon_payments
Boolean indicator that Amazon Payments are accepted
credit_card
Boolean indicator that credit cards are accepted
other
Boolean indicator that other forms of payment are accepted
paypal
Boolean indicator that Paypal payments are accepted
reasons
Array of reasons containing one or more of 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
Conditions for refunds
custom
Boolean indicator of a custom refund policy
group_closes
refund applies when the group closes
member_banned
refund applies when the member is banned
member_leaves
refund applies when member leaves the group
none
indicates there is no refund policy
required
true if dues are required
required_to
If the dues are required this indicates what they are required for. May be one of 'join' or 'rsvp'
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
Name of the group
next_event
The next upcoming event, if the group has one
id
Alphanumeric event ID
name
Name of event
time
UTC start time of the event, in milliseconds since the epoch
organizer
Group's primary organizer
bio
Bio of member
id
Numeric member ID
name
Name of member
photos
A small set of photos from the group
highres_link
Link for full sized photo
id
Numeric photo ID
photo_link
Link for standard sized photo
thumb_link
Link for thumbnail sized photo
self
Optional field, contains details specific to the authorized user if an active member of this group
actions
list of actions the current user may perform, potentially "event_create": the ability to create new events, "event_draft": the ability to save new events as drafts, "role_assign": the ability to assign member roles, or "edit": the ability to edit group settings
membership_dues
Member's membership dues if the group has membership dues
cancelled
For groups with recurring billing periods, this Boolean field indicates that membership dues were cancelled
exempt
For groups with recurring billing periods, this Boolean field indicates that the member is exempt from payment.
paid_until
For groups with recurring billing periods, this returns the time in milliseconds since the epoch that the member's next payment is due
period_status
For groups with recurring billing periods, this returns one of the following values grace paid pending unpaid
total_amount
Total amount paid
transaction_time
Time the transaction was made in milliseconds since the epoch
trial
If the group offers a trial membership, this indicates information for unpaid members.
role
Member's role in group, if any: Organizer, Assistant Organizer, Event Organizer, etc.
status
Optional fields property returned when 'self_status' is provided. Indicates the authorized user's membership with this group. Value may be one of pending, pending_payment, active, blocked or none
visited
Member's last visit to the group site, in milliseconds since the epoch
short_link
Optional field, a shorted URL for the group
similar_groups
Optional fields parameter. Returns up to 5 groups similar to this groups
id
Id of the group
join_mode
Who can join this group and how. One of approval, closed, open
lat
Latitude
lon
Longitude
name
Name of the group
photos
Optional fields parameter. A small set of photos from the group
highres_link
Link for full sized photo
id
Numeric photo ID
photo_link
Link for standard sized photo
thumb_link
Link for thumbnail sized photo
urlname
Urlname used to identify the group on meetup.com
who
What this group calls it's members
simple_html_description
Description of the group, in simple HTML source format. If this group's description was saved in simple HTML format, the description field will be an HTML translation of this source
state
State of the group, if in US or Canada
timezone
This represents the universal timezone identifier for the group
topics
Optional fields parameter. Returns the group's topics
id
Numeric topic id
lang
Language topic originates from
name
Display name of the topic
urlkey
The unique keyword used to identify this topic
urlname
Urlname used to identify the group on meetup.com
visibility
Who can see this group. One of members, public or public_limited
welcome_message
Optional fields parameter. Returns the Group's default welcome message if the authenticated member is the organizer of the group
who
What the group calls its members

API methods

everywhere seed events

Sign up

Meetup members, Log in

By clicking "Sign up" or "Sign up using Facebook", you confirm that you accept our Terms of Service & Privacy Policy