Skip to content
OAuth Clients

Queries

Stuck? Visit the Meetup API Guide!
We prepared a set of examples to help you leverage the Meetup GraphQL API.
Visit Guide

checkIfGroupUrlnameValid

Check if the urlname isn't used by another group and follows validation rules
Arguments:
urlname(String)REQUIRED
Alphanumeric urlname identifier for the group
Response:
CheckIfGroupUrlnameValidResultREQUIRED

event

Returns an event according to requested id
Arguments:
id(ID)
Alphanumeric identifier for the event
Response:
Event

findLocation

Find the location of a specific event
Arguments:
query(String)
String pattern to searching by occurrence
lat(Float)
Latitude of central point of presence. If provided, must be provided with lon
lon(Float)
Longitude of central point of presence. If provided, must be provided with lat
variant(String)
Experiment Variant
Response:
[Location]

groupByUrlname

Fetch a single group by urlname instead of id. Allows access to any group field urlname: unique url portion that identifies a group Returns null if no group matches the given urlname
Arguments:
urlname(String)REQUIRED
Urlname used to identify the group on meetup.com
Response:
Group

healthCheck

Query if the Meetup GraphQL API is working as expected
Response:
String

keywordSearch

Search groups or events by the group name or the event title
Arguments:
input(ConnectionInput)
Parameters for search
filter(SearchConnectionFilter)REQUIRED
Filter to minimize the list of results
sort(KeywordSort)
How results should be sorted
Response:
SearchConnectionREQUIRED

proNetwork

Query a Pro Network by id
Arguments:
id(ID)REQUIRED
Pro Network Id
Response:
ProNetwork

proNetworkByUrlname

Query a Pro Network by urlname
Arguments:
urlname(String)REQUIRED
Pro Network urlname
Response:
ProNetwork

self

Query data about requester
Response:
User

suggestTopics

Suggest topics by name
Arguments:
query(String)REQUIRED
excludeMemberTopics(Boolean)
Response:
TopicsConnectionREQUIRED

Mutations

addGroupToNetwork

Add a group to a Pro Network by group Id and network Id
Arguments:
input(AddGroupToNetworkInput)REQUIRED
Input data with parameters for adding the group
Response:
AddGroupToNetworkPayloadREQUIRED

addGroupToNetworkByUrlname

Add a group to a Pro Network by group urlname and network urlname
Arguments:
input(AddGroupToNetworkByUrlnameInput)REQUIRED
Input data with parameters for adding the group
Response:
AddGroupToNetworkPayloadREQUIRED

announceEvent

Request to announce the event
Arguments:
input(AnnounceEventInput)REQUIRED
Parameters of the event for announcing
Response:
AnnounceEventPayloadREQUIRED

closeEventRsvps

Request to close a possibility to accept RSVPs
Arguments:
input(CloseEventRsvpsInput)REQUIRED
Parameters of the event
Response:
CloseEventRsvpsPayloadREQUIRED

createEvent

Request to create an event
Arguments:
input(CreateEventInput)REQUIRED
Response:
CreateEventPayloadREQUIRED

createGroupDraft

Request to create a new group draft
Arguments:
input(CreateGroupDraftInput)REQUIRED
Initial data for creating a draft of the group
Response:
CreateGroupDraftPayload

createVenue

Arguments:
input(CreateVenueInput)REQUIRED
Response:
CreateVenuePayloadREQUIRED

deleteEvent

Request to delete event
Arguments:
input(DeleteEventInput)REQUIRED
Parameters of the event and instructions for a schedule and series of events
Response:
DeleteEventPayloadREQUIRED

editEvent

Request to edit the event
Arguments:
input(EditEventInput)REQUIRED
Parameters for updating event data
Response:
EditEventPayloadREQUIRED

openEventRsvps

Request to open a possibility to accept RSVPs
Arguments:
input(OpenEventRsvpsInput)REQUIRED
Parameters of the event
Response:
OpenEventRsvpsPayloadREQUIRED

publishEventDraft

Request to publish the event draft
Arguments:
input(PublishEventDraftInput)REQUIRED
Parameters of the event for publishing
Response:
PublishEventDraftPayloadREQUIRED

publishGroupDraft

Request to publish the existing group draft
Arguments:
input(PublishGroupDraftInput)REQUIRED
Parameters of the group draft
Response:
PublishGroupDraftPayload

updateGroup

Changes any field of a group using its id to identify it. Returns null if input.id does not match any group, otherwise returns the updated group fields
Arguments:
input(UpdateGroupInput)REQUIRED
Parameters that will be used for group updating
Response:
UpdateGroupPayloadREQUIRED

updateGroupDraft

Request to update the existing group draft
Arguments:
input(UpdateGroupDraftInput)REQUIRED
Data for editiong a draft of the group
Response:
UpdateGroupDraftPayload

updateGroupSettings

Changes group setting fields from the indicated group using its id to identify it. input: id and fields that will be updated on the group upon calling this mutation Returns null if input.id does not match any group, otherwise returns the updated group fields
Arguments:
input(UpdateGroupSettingsInput)REQUIRED
Response:
UpdateGroupSettingsPayloadREQUIRED

uploadImage

Create group image - upload an image to the main group album. PhotoType should be GROUP_PHOTO.
Arguments:
input(ImageUploadInput)REQUIRED
Input parameters for uploading the image
Response:
ImageUploadPayload

Objects

AddGroupToNetworkPayload

object
Fields:
group(Group)
Group which has been added or null in case of error
network(ProNetwork)
Pro Network where the group has been added to or null in case of error
errors([PayloadError])
List of error or null if the group has been successfuly added to Pro Network

AnnounceEventPayload

object
Fields:
event(Event)
The event which has been announced
errors([PayloadError])
Null if event has been successfuly announced or array of errors if something gone wrong

CheckIfGroupUrlnameValidResult

object
Fields:
isValid(Boolean)REQUIRED
Indicates if urlname is valid
urlname(String)
Formatted urlname
error(PayloadError)

CloseEventRsvpsPayload

object
The results of closing RSVP of the event
Fields:
event(Event)
The event with which the operation was carried out
errors([PayloadError])
Null if closing was successful or array of errors if something gone wrong

CovidPrecautions

object
Fields:
masks(CovidPrecautionMaskPolicy)
Policy on wearing masks
vaccinations(CovidPrecautionVaccinePolicy)
Policy on vaccinations
venueType(CovidPrecautionVenueType)
Venue type
details(String)
Free-form detailed information organizer provides

CreateEventPayload

object
Fields:
event(Event)
The created draft of the event
errors([PayloadError])
Null if creation was successful or array of errors if something gone wrong

CreateGroupDraftPayload

object
The result of creating the draft of the group
Fields:
token(ID)
A token identifying a group draft
group(Group)
The group with requested and default properties
errors([PayloadError])
List of errors in case of failed creation

CreateVenuePayload

object
Fields:
venue(Venue)
didYouMean([Venue])
In the event a duplicate venue in the system is detected, this list will provide a list of suggestions you might have been looking for
errors([PayloadError])

CurrentSubscription

object
Member's current subscription.
Fields:
renewalDate(DateTime)
Current plan renewal date.
startDate(DateTime)
Current plan start date
trialEndDate(DateTime)
Current trial end date.
creditForUnusedTime(Int)
Credit for unused subscription time
isTaxEnabled(Boolean)REQUIRED
Defines if tax is enabled. Be sure to pass IP request header `X-Forwarded-For` to make this field work properly
lastPayment(SubscriptionPayment)
Subscription last payment details
appliedPromotion(SubscriptionPromotion)
Promotion applied to the subscription
plan(SubscriptionProfilePlan)REQUIRED
Current plan

DeleteEventPayload

object
The result of deleting the event
Fields:
success(Boolean)
True if event has been successfuly deleted
errors([PayloadError])
Null if event has been successfuly deleted or array of errors if something gone wrong

Donation

object
Fields:
title(String)
orgName(String)REQUIRED
url(String)REQUIRED

DraftEventConnection

object
A paginated result of group draft events
Fields:
pageInfo(PageInfo)REQUIRED
Information to aid in pagination
count(Int)REQUIRED
The total number of edges
edges(DraftEventEdge)REQUIRED
A list of draft edges

DuesCheckoutSettings

object
Membership dues settings required for a dues checkout page.
Fields:
groupName(String)REQUIRED
A Meetup group name.
amount(Int)
Dues amount in US cents.
currency(String)
Dues currency
interval(DuesInterval)
Dues interval.
duesReasons(DuesReasons)
An optional object listing reasons why the group collects membership dues.
trialPeriodDays(Int)
Dues trial period in days.
isMemberExempt(Boolean)REQUIRED
A flag indicating whether the current member is exempt from paying dues.
cards([DuesMemberCard])
An optional list of saved cards for the current member.
publishableKey(String)
A Stripe API publishable key.
periodEnd(String)
If the current member has a dues subscription, the end of the subscription's current billing period.
canCheckout(Boolean)REQUIRED
A flag indicating if a member can pay dues in the group.
membershipInfo(MembershipInfo)REQUIRED
Membership information for the current group and member.
isCanceled(Boolean)REQUIRED
A flag indicating whether the current member has canceled auto-renewal of their dues subscription. Returns false if the member does not have an active dues subscription.

EditEventPayload

object
Fields:
event(Event)
The event with which the operation was carried out
errors([PayloadError])
Null if event has been successfuly edited or array of errors if something gone wrong

Event

object
Fields:
id(ID)REQUIRED
Alphanumeric identifier for the event
token(String)
Calculated identifier for an autoscheduled event
title(String)
Title of the event
eventUrl(String)REQUIRED
Name used for the event's web address on meetup.com. Must be between 6 and 60 characters
description(String)
Description of the event
shortDescription(String)
Short description of the event
host(User)
User who host the event
hostPhoto(Image)
Host's group photo
howToFindUs(String)
group(Group)
Group which the event belong to
venue(Venue)
Venue of the event
images(Image)REQUIRED
Images of the event
onlineVenue(OnlineVenue)
If event is inline
status(EventStatus)
Status of the event
timeStatus(EventTimeStatus)
Time Status of the event
dateTime(ZonedDateTime)REQUIRED
Date of the event
duration(Duration)REQUIRED
Duration of the event
timezone(String)REQUIRED
Timezone where the event is happened
endTime(ZonedDateTime)REQUIRED
Time when event ends
createdAt(ZonedDateTime)
Date when event has been created
priceTier(EventPriceTier)REQUIRED
Price tier of the event
fees(Fees)
Fees of the event
taxType(String)
Type of tax for payment
donation(Donation)
Donation of the event
maxTickets(Int)REQUIRED
Maximum amount of tickets available for the event
waitlistMode(WaitlistMode)REQUIRED
Waitlist handling when RSVP limit is reached
going(Int)REQUIRED
Numbers of participants
waiting(Int)REQUIRED
Number of waitlisted members
tickets(EventTicketsConnection)REQUIRED
List of tickets
rsvpSearch(RsvpSearchConnection)REQUIRED
Search for members RSVP's in this event
isAttending(Boolean)
If particular user attends the event
attendingTicket(Ticket)
Tiket of the requester
eventType(EventType)REQUIRED
Type of the event
isSaved(Boolean)REQUIRED
If event is saved
isDeletable(Boolean)REQUIRED
True whenver the event may be deleted by the requesting user.
isOnline(Boolean)REQUIRED
True whenever the event is online.
isNetworkEvent(Boolean)REQUIRED
True if the event is part of a network event
imageUrl(String)REQUIRED
Url for a image representing the event, or a fallback image. NOTE: this is under development, do not use yet.
image(EventImage)REQUIRED
Image of the event
shortUrl(String)REQUIRED
A shortened link for the event
hosts([User])
List of members who will be hosts of the event
hostRsvps(HostRsvpsConnection)REQUIRED
A list of RSVP's for hosts of the event
uiActions(EventUiActions)REQUIRED
The actions that a member can take on the event
rsvpEventQuestion(RsvpQuestion)
Event RSVP question details
rsvpSurveySettings(RsvpSurveySettings)
Pro event RSVP survey settings
rsvpState(RsvpState)
The state of the current user's RSVP for this event
rsvpSettings(RsvpOpenSettings)
Settings for when members can rsvp
comments(EventCommentConnection)REQUIRED
Event comments
commentLikes(EventCommentLikerConnection)REQUIRED
Event comment likers
guestsAllowed(Boolean)REQUIRED
True if the event allows members to bring guests
numberOfAllowedGuests(Int)REQUIRED
Number of allowed guests
photoAlbum(EventPhotoAlbum)
Event photo album
isProEmailShared(Boolean)
True whenever the member shares email with pro network
descriptionImageUrls([String])
List of image URLs parsed from event description
topics(TopicsConnection)REQUIRED
List of topics associated with the event
proCompleteRsvp(ProCompleteRsvp)REQUIRED
Pro event complete RSVP details
calendarExportUrls(CalendarExportUrls)
A collection of links for exporting event information to an external calendar system for a given member
covidPrecautions(CovidPrecautions)REQUIRED
Organizer defined COVID-19 precautions
fundraising(EventFundraising)
Settings related to fundraising
feeSettings(EventFeeSettings)
Optional organizer-defined fee payment settings
zoomMeetingId(ID)
A Zoom meeting ID if the event is online and uses Zoom integration.
series(Series)
If this event is part of a series, this field describes that series
isNewGroup(Boolean)
Indicates if the group has been recently created
channelUrl(String)
Indicates if the group has been recently created
isFeatured(Boolean)REQUIRED
Returns true of the event is a featured event
template(EventTemplate)
If an event was created from a template, the template metadata.
creatorMember(User)
Indicates member who created the event
networkEvent(NetworkEvent)
Network event details

EventDraft

object
Fields:
id(ID)REQUIRED
updatedAt(ZonedDateTime)REQUIRED
eventType(EventType)
title(String)
description(String)
shortDescription(String)
host(User)
hostPhoto(Image)
howToFindUs(String)
group(Group)
venue(Venue)
images(Image)REQUIRED
onlineVenue(OnlineVenue)
onlineUrl(String)
announceStatus(EventAnnounceStatus)
status(EventStatus)
isPublishable(Boolean)REQUIRED
isDeletable(Boolean)REQUIRED
dateTime(ZonedDateTime)
dates
duration(Duration)
timezone(String)
endTime(ZonedDateTime)
createdAt(ZonedDateTime)REQUIRED
priceTier(EventPriceTier)
monies
fees(Fees)
currency(String)
price(Int)
taxType(String)
donation(Donation)
maxTickets(Int)

EventImage

object
The Image for the event
Fields:
id(ID)REQUIRED
Id of the image
baseUrl(String)REQUIRED
The url where the image has been stored

EventPhotoAlbum

object
Fields:
id(ID)REQUIRED
title(String)REQUIRED
photoCount(Int)REQUIRED
photoSample(Image)REQUIRED

EventTicketsConnection

object
The list of paginated tickets with aggregate data
Fields:
pageInfo(PageInfo)REQUIRED
Information about pagination position
count(Int)REQUIRED
The total number of edges, after TicketsConnectionInput status filters are applied. In particular requesting YES, NO, and WAITLIST status filters affect the number this returns.
edges(EventTicketsEdge)REQUIRED
A list of edges
yesCount(Int)
Total overall count of yes RSVPS, regardless of TicketsConnectionInput status filters
noCount(Int)
Total overall count of no RSVPS, regardless of TicketsConnectionInput status filters
waitlistCount(Int)
Total overall count of waitlisted RSVPS, regardless of TicketsConnectionInput status filters
attendedCount(Int)
Total overall count of members marked as attended, regardless of TicketsConnectionInput status filters
absentCount(Int)
Total overall count of members marked as absent, regardless of TicketsConnectionInput status filters
noShowCount(Int)
Total overall count of members marked as a no show, regardless of TicketsConnectionInput status filters

EventTicketsEdge

object
A ticket, also known as an RSVP
Fields:
cursor(String)REQUIRED
Represents the position of the item inside a list of edges
node(Ticket)REQUIRED
Contains information about the ticket

Fee

object
Fields:
type(FeeType)REQUIRED
amount(Int)REQUIRED

Fees

object
Fields:
processingFee(Fee)
serviceFee(Fee)
tax(Fee)

Group

object
extension on existing type
Fields:
unifiedEvents(GroupEventsConnection)REQUIRED
Events of the group
id(ID)REQUIRED
ID of the group
logo(Image)
Image of a logo of the group
isPrivate(Boolean)REQUIRED
If the group is private
isMember(Boolean)REQUIRED
If the requester is a member of the group
isOrganizer(Boolean)REQUIRED
If the reauester is an organiser of the group
isPrimaryOrganizer(Boolean)REQUIRED
If organizer is a primary organizer of the group
latitude(Float)
Latitude of the group location
longitude(Float)
Longtitude of the group location
proJoinDate(ZonedDateTime)
Date of joining to pro network
foundedDate(ZonedDateTime)
Date when the group was founded
topics(Topic)REQUIRED
List of group topics
topicCategory(TopicCategory)
Topic Category mapped from Chapter Category
description(String)
Description of the group
customMemberLabel(String)
Custom label of the group
name(String)
Display name of the group. Can be at most 60 characters
urlname(String)
Urlname used to identify the group on meetup.com
timezone(String)
This represents the universal timezone identifier for the group
city(String)
City of the group
state(String)
State of the group, if in US or Canada
country(String)
The ISO_3166-1 like country code for the country which contains the city (lower case code)
zip(String)
The zip code
groupPhoto(Image)
Photo object for the group
link(String)
Link for the group on meetup.com
proNetwork(ProNetwork)
Pro network object which manage current group. Return `null` if group does not belong to network
sponsors(GroupSponsorConnection)REQUIRED
List of the sponsors for the group
stats(GroupStats)
Statistics for the group, containing member counts
memberships(GroupUserConnection)REQUIRED
List of members for the group
membershipSearch(MembershipSearchConnection)REQUIRED
Search for members within the group
eventSearch(GroupEventSearchConnection)REQUIRED
Search for events in this group
emailListAddress(String)
Email List Address
joinMode(GroupJoinMode)
The way a new member let into the group
needsPhoto(Boolean)
Indicates if new member profile have to provide a photo
needsQuestions(Boolean)
Indicates if new member must answer questions to join
questions(GroupQuestion)REQUIRED
Questions that a new member have to answer to join
welcomeBlurb(String)
Welcome message to new members
membershipDues(DuesCheckoutSettings)
Retrieves dues checkout settings for the group and member
duesSettings(DuesSettings)
Retrieves dues settings for the group
membershipMetadata(GroupMembership)
Member's membership metadata
draftEvents(DraftEventConnection)REQUIRED
List of draft events for the group
pastEvents(PastEventConnection)REQUIRED
List of past events for the group
upcomingEvents(UpcomingEventsConnection)REQUIRED
List of upcoming events for the group
video(GroupVideo)
Group featured video.
venues(GroupVenueConnection)REQUIRED
Recently used in-person venues
stepUpInfo(StepUpInfo)
group stepup info
experiments(ExperimentPayload)REQUIRED
Enrollment information for the requested experiments (split tests). NOTE: the query works for all experiment entity types (member, browser, group), but it's primary purpose is to support the 'GROUP' experiments.
featuredEventPhotos(FeaturedEventPhotoConnection)REQUIRED
Returns a list of recently used event photos
isNewGroup(Boolean)
Indicates if the group has been recently created
groupApprovalStatus(GroupApprovalStatus)
Status of group approval in NGQ
featuredEvent(Event)
The featured event for this group if one exists
fundraising(GroupFundraising)
Settings related to fundraising. This may be null if the group has not yet set up fundraising.
mailingListMode(GroupMailingListMode)
Mailing list settings
status(GroupStatus)REQUIRED
Status of the group
organizer(GroupOrganizer)
Group organizer info
groupAnalytics(GroupAnalytics)
Groups analytics, only available for groups which are part of a pro network

GroupAnalytics

object
Fields:
genderMembershipRatios(GroupGenderMembershipRatios)
Proportion of members in the group by gender
totalMembers(Int)
Number of the group members
lastEventDate(ZonedDateTime)
Date of the last meetup event, not present if the group never had a meetup event
averageAge(Float)
Average age of the group members
totalPastEvents(Int)
Number of the past meetup events
totalPastRsvps(Int)
Number of total RSVPs in the past
totalRepeatRsvpers(Int)
Number of members who RSVPed to a past event and RSVPs to a new event
averageRsvpsPerEvent(Float)
Average number of RSVPs per event
totalUpcomingEvents(Int)
Number of the upcoming meetup events

GroupEventsConnection

object
Fields:
pageInfo(PageInfo)REQUIRED
count(Int)REQUIRED
edges(GroupEventsEdge)REQUIRED

GroupEventsEdge

object
Fields:
cursor(String)REQUIRED
node(Event)REQUIRED

GroupGenderMembershipRatios

object
Fields:
femaleRatio(Float)
Proportion of members who identify as female
maleRatio(Float)
Proportion of members who identify as male
otherRatio(Float)
Proportion of members who identify as gender other than male or female
unknownRatio(Float)
Proportion of members whose gender is unknown

GroupMembership

object
Information about membership
Fields:
status(MembershipStatus)REQUIRED
The status of membership
role(MembershipRole)
The role of membership
mostRecentVisitDate(ZonedDateTime)
When the member last visited the group
joinedDate(ZonedDateTime)
When the member joined the group
bio(String)
Member's bio for the group
noShowCount(Int)
The number of times this member was marked as a no show in this group. currently only available in the context of a Ticket
preferences([Preference])
Group preferences
dues(MembeshipDues)
Group membership dues data
memberPhoto(Image)
Group member photo

GroupQuestion

object
Fields:
id(ID)REQUIRED
question(String)REQUIRED
sort(Int)REQUIRED

GroupSponsorConnection

object
A paginated result of group sponsors
Fields:
pageInfo(PageInfo)REQUIRED
Information to aid in pagination
count(Int)REQUIRED
The total number of edges
edges(GroupSponsorEdge)REQUIRED
A list of sponsor edges

GroupStats

object
The statistic of the membership in the group
Fields:
memberCounts(GroupMemberCounts)REQUIRED
The statistics of the members in the group
members(TotalAndActiveMembersPayload)REQUIRED
Retrieves data for the Total and Active members chart
joins(GroupJoinsPayload)REQUIRED
Retrieves data for the Group Joins chart
rsvps(GroupRsvpsPayload)REQUIRED
Retrieves data for the RSVPs chart
csv(GroupCsvPayload)REQUIRED
Retrieves url for the Group stats CSV

GroupUserConnection

object
The list of users with a pagination
Fields:
edges(GroupUserEdge)REQUIRED
A list of edges
pageInfo(PageInfo)REQUIRED
Information about pagination in a connection
count(Int)REQUIRED
The total number of edges

Image

object
The image entity
Fields:
id(ID)REQUIRED
Id of the image
baseUrl(String)
Base url of the image
preview(String)
An image coded in Base64

ImageUploadPayload

object
The result of request for uploading the image
Fields:
uploadUrl(String)REQUIRED
The url, which can be used for uploading the image
image(Image)REQUIRED
The object which contain the image info
imagePath(String)REQUIRED
image url
error(PayloadError)
will only be populated if there is a non-system error during processing

Location

object
Fields:
city(String)
Name of city
country(String)
Two character country code
localized_country_name(String)
Localized name of country based on request's language information
state(String)
Enclosing location state, if the location's country declares one
name_string(String)
The full name of the location as preformatted string
zip(String)
The location's zip code. For locations in countries without zip codes, a placeholder will be returned
lat(Float)
Approximate location latitude
lon(Float)
Approximate location longitude
borough(String)
Borough/Town/District name
neighborhood(String)
Neighborhood name

OnlineVenue

object
Fields:
type(OnlineVenueType)REQUIRED
url(String)

OpenEventRsvpsPayload

object
Fields:
event(Event)
The event with which the operation was carried out
errors([PayloadError])
Null if oppening was successful or array of errors if something gone wrong

PageInfo

object
Information about pagination in a connection
Fields:
hasNextPage(Boolean)REQUIRED
A boolean value that indicates whether the end of the list was reached (only relevant when paginating forward through a list)
hasPreviousPage(Boolean)REQUIRED
A boolean value that indicates whether the beginning of the list was reached (only relevant when paginating backwards through a list)
startCursor(String)REQUIRED
A cursor that represents the first edge in the list of edges for this query
endCursor(String)REQUIRED
A cursor that represents the last edge in the list of edges for this query

PastEventConnection

object
A paginated result of group past events
Fields:
pageInfo(PageInfo)REQUIRED
Information to aid in pagination
count(Int)REQUIRED
The total number of edges
edges(PastEventEdge)REQUIRED
A list of past events edges

PastEventEdge

object
Fields:
cursor(String)REQUIRED
Represents the position of the item inside the list of edges
node(Event)REQUIRED
Contains information about the past event

PayloadError

object
Fields:
code(String)REQUIRED
message(String)REQUIRED
field(String)

ProCompleteRsvp

object
Fields:
isEnabled(Boolean)REQUIRED
link(String)

ProNetwork

object
Represents pro network information
Fields:
id(ID)REQUIRED
ID of the network
urlname(String)REQUIRED
Urlname used to identify the network on meetup.com
name(String)REQUIRED
Display name of the network
status(ProNetworkStatus)REQUIRED
Status of the network, one of ACTIVE | INACTIVE | FROZEN
link(String)REQUIRED
Link for the network on meetup.com
logo(Image)
Photo object for the logo
description(String)
Description of the network
externalUrl(String)
External URL of the network
contactEmail(String)
Contact email of the network
primaryAdmin(User)
Primary administrator of the network
isMemberEmailShared(Boolean)REQUIRED
A boolean value that indicates whether member shared email with the network or not
sponsors(GroupSponsor)REQUIRED
List of sponsors which belong to the network
usersSearch(ProNetworkUsersConnection)
Search through list of users with analytics which belong to the network
groupsSearch(ProNetworkGroupsConnection)
Search through list of groups with analytics which belong to the network
eventsSearch(ProNetworkEventsConnection)REQUIRED
Search through list of events which belong to the network
rsvpsSearch(ProNetworkRsvpConnection)REQUIRED
Returns positive RSVPs for a network sorted by update time
suggestedEvents(ProNetworkSuggestedEventsConnection)REQUIRED
Get suggested network events, pagination is not supported currently
rsvpSurveys(ProNetworkRsvpSurveysConnection)REQUIRED
A list of RSVP responses for the events across the entire Pro network
mailchimpLists(MailchimpList)REQUIRED
Get MailChimp members lists
mailchimpAuth(MailchimpAuth)
Get MailChimp account connection details
paymentModel(ProNetworkPaymentModel)REQUIRED
Payment model of the network
networkAnalytics(ProNetworkAnalytics)
Pro network stats
socialNetworks(SocialNetwork)REQUIRED
A list of links to network's social platforms
visualSettings(ProNetworkVisualSettings)REQUIRED
Visual settings for the network

ProNetworkEventEdge

object
Fields:
cursor(String)REQUIRED
Pointer to an event in the list
node(Event)REQUIRED
An event entity

ProNetworkEventsConnection

object
Fields:
pageInfo(PageInfo)REQUIRED
Information of the current page of a total list
count(Int)REQUIRED
Total count of found events
edges(ProNetworkEventEdge)REQUIRED
List of found events

ProNetworkGroupEdge

object
Fields:
cursor(String)REQUIRED
Pointer to a group in the list
node(Group)REQUIRED
A group entity

ProNetworkGroupsConnection

object
Fields:
pageInfo(PageInfo)REQUIRED
Information of the current page of a total list
count(Int)REQUIRED
Total counts of Pro Network Groups
edges(ProNetworkGroupEdge)REQUIRED
List of Pro Network Groups

ProNetworkRsvpConnection

object
Fields:
edges(ProNetworkRsvpEdge)REQUIRED
List of found rsvps
pageInfo(PageInfo)REQUIRED
Information of the current page of a total list
count(Int)REQUIRED
Total count of found events

ProNetworkRsvpEdge

object
Fields:
cursor(String)REQUIRED
Pointer to an rsvp in the list
node(Ticket)REQUIRED
A rsvp value

ProNetworkRsvpSurvey

object
Fields:
id(ID)REQUIRED
Unique identifier for the RSVP survey
event(Event)REQUIRED
Event for the RSVP survey
user(User)REQUIRED
User who participates in the RSVP survey
updatedAt(ZonedDateTime)REQUIRED
Timestamp of the last time RSVP response was modified
answers([RsvpSurveyAnswer])
List of answers

ProNetworkRsvpSurveyEdge

object
Fields:
cursor(String)REQUIRED
Pointer to a RSVP survey in the list
node(ProNetworkRsvpSurvey)REQUIRED
A Pro Network Survey entity

ProNetworkRsvpSurveysConnection

object
Fields:
pageInfo(PageInfo)REQUIRED
Information of the current page of a total list
count(Int)REQUIRED
Total count of found RSVP surveys
edges(ProNetworkRsvpSurveyEdge)REQUIRED
List of found RSVP surveys

ProNetworkUserAnalytics

object
Fields:
isOrganizer(Boolean)
Whether a User is organizer
eventsAttended(Int)
The number of attended events
lastAccessTime(DateTime)
The time when the last activity occured
role(MemberRole)
Highest member role across all groups within Pro network
groupsCount(Int)
Count of groups where user is actual member
groups([Group])
List of groups where user is actual member

ProNetworkUserEdge

object
Fields:
cursor(String)REQUIRED
Pointer to a user in the list
node(User)REQUIRED
A user entity
metadata(ProNetworkUserAnalytics)

ProNetworkUsersConnection

object
Fields:
pageInfo(PageInfo)REQUIRED
Information of the current page of a total list
count(Int)REQUIRED
Total count of found Pro Networks users
edges(ProNetworkUserEdge)REQUIRED
List of found Pro Networks users

PublishEventDraftPayload

object
Fields:
event(Event)
The event with which the operation was carried out
errors([PayloadError])
Null if event has been successfuly published or array of errors if something gone wrong

PublishGroupDraftPayload

object
The result of publishing the group
Fields:
group(Group)
The group which has been published
errors([PayloadError])
Null if publishing was successful or array of errors if something gone wrong

RootEventsConnection

object
The list of events with a pagination
Fields:
pageInfo(PageInfo)REQUIRED
Information about pagination in a connection
count(Int)REQUIRED
The total number of edges
edges(RootEventsEdge)REQUIRED
A list of edges

RootEventsEdge

object
An event item
Fields:
cursor(String)REQUIRED
Represents the position of the item inside the list of edges
node(Event)REQUIRED
Contains information about the actual item

RsvpOpenSettings

object
Fields:
rsvpOpenTime(DateTime)
rsvpCloseTime(DateTime)
rsvpsClosed(Boolean)

RsvpQuestion

object
Fields:
id(ID)REQUIRED
question(String)REQUIRED
required(Boolean)REQUIRED
answer(String)

RsvpSurveyAnswer

object
Fields:
question(String)REQUIRED
Question of the survey
answer(String)REQUIRED
Answer to the question of the survey

RsvpSurveySettings

object
Fields:
requiresProQuestionnaire(Boolean)REQUIRED
enabledByDefault(Boolean)REQUIRED
isSponsored(Boolean)REQUIRED
sponsor(RsvpSurveySettingsSponsor)
questions(RsvpSurveySettingsQuestion)REQUIRED

RsvpSurveySettingsQuestion

object
Fields:
questionId(String)REQUIRED
text(String)REQUIRED
type(String)REQUIRED
required(Boolean)REQUIRED
characterLimit(Int)REQUIRED

RsvpSurveySettingsSponsor

object
Fields:
name(String)REQUIRED
url(String)

SearchConnection

object
The result of search by keyword
Fields:
pageInfo(PageInfo)REQUIRED
Information about pagination in a connection
count(Int)REQUIRED
Number of found events or groups in the search result
edges(SearchResultEdge)REQUIRED
A result of the search

SearchResult

object
One result of the search
Fields:
id(ID)REQUIRED
The ID of a result
result(SearchNode)REQUIRED
The content of a result

SearchResultEdge

object
One result of the search with additional data
Fields:
cursor(String)REQUIRED
The first record in a page list
node(SearchResult)REQUIRED
One element of result
recommendationId(String)
The ID of a recommendation record
recommendationSource(String)
The source of recomendation records

StarbucksInfo

object
Starbucks related metadata
Fields:
id(ID)REQUIRED
ID
storeName(String)REQUIRED
Name of the store
group(Group)
Linked group

SubscriptionProfile

object
Describes an organizer subscription configuration available to a member.
Fields:
plans(SubscriptionProfilePlan)REQUIRED
A list of subscription plans.
currentSubscription(CurrentSubscription)
Current subscription for a member.
savedStripeCards(MemberStripeCard)REQUIRED
Member's saved cards
promoCode(SubscriptionPromoCode)
A promo code for promotion.
promotions(SubscriptionPromotionWrapper)REQUIRED
A list of promotions corresponding to available subscription plans.

SubscriptionProfileDiscount

object
An available subscription discount.
Fields:
percentOff(Float)REQUIRED
A discount percentage.
duration(SubscriptionProfileDiscountDuration)REQUIRED
A discount duration.

SubscriptionProfilePlan

object
A subscription plan available to a member.
Fields:
id(ID)REQUIRED
A plan id.
amount(Int)REQUIRED
A plan unit amount (USD cents).
minQuantity(Int)REQUIRED
A minimum number of units the organizer is paying for a plan.
quantity(Int)REQUIRED
A number of units the organizer is paying for: a number of groups for per-group plans or 1 for flat plans.
billInterval(Int)REQUIRED
A plan billing interval.
billIntervalUnit(BillIntervalUnit)REQUIRED
A plan billing interval unit.
isSavingsPlan(Boolean)REQUIRED
A flag indicating whether this is a "savings" plan.
renewalCopy(String)REQUIRED
A localized renewal copy for a plan.
tier(SubscriptionTier)REQUIRED
A tier label for a plan.
description(String)REQUIRED
A localized description for a plan.
providerPlanId(ID)REQUIRED
A payment provider's plan ID
internalPlanId(ID)REQUIRED
An internal plan id

SubscriptionPromoCode

object
Fields:
code(String)REQUIRED
Promo code provided via the promoCode query argument.
valid(Boolean)REQUIRED
Boolean indicating whether the promo code is valid.
error(SubscriptionPromoCodeError)
Provided promo code is not valid for the member.
promotion(String)
Promotion name

SubscriptionSummary

object
The summary information of an organizer's current subscription
Fields:
id(ID)REQUIRED
Current plan id
status(SubscriptionStatus)REQUIRED
Current subscription status
processor(PaymentProcessor)
The payment processor used for the current subscription
memberCard(MemberStripeCard)
Current subscription card

Ticket

object
Fields:
id(ID)REQUIRED
event(Event)REQUIRED
user(User)REQUIRED
membership(GroupMembership)
quantity(Int)REQUIRED
createdAt(ZonedDateTime)REQUIRED
updatedAt(ZonedDateTime)REQUIRED
url(String)REQUIRED
status(TicketStatus)REQUIRED
A ticket status.
guestsCount(Int)REQUIRED
isHost(Boolean)REQUIRED
Indicator that the member associated with this RSVP is a host for this event
isFirstEvent(Boolean)REQUIRED
Indicator that this RSVP is the first RSVP for member associated with the RSVP
answer(TicketAnswer)
payStatus(PayStatus)
The current event payment status for the RSVP for ticketed events from the perspective of the provided memberId. A payment status is only available if the RSVP belongs to the calling member or if the calling member has permission to manage money within the hosting group.
uiActions(RsvpActions)REQUIRED
A list of actions a member may perform on a given RSVP

Topic

object
Fields:
urlkey(String)REQUIRED
Urlname used to identify the topic on meetup.com
name(String)REQUIRED
Name of the topic
id(ID)REQUIRED
ID of the topic

TopicCategory

object
Fields:
id(ID)REQUIRED
urlkey(String)REQUIRED
name(String)REQUIRED
color(String)REQUIRED
imageUrl(String)REQUIRED
experimental image associated with the TopicCategory. subject to change
defaultTopic(Topic)REQUIRED

TopicEdge

object
Fields:
cursor(String)REQUIRED
Pointer to a Topic
node(Topic)REQUIRED
A topic entity

TopicsConnection

object
Search through list of topics
Fields:
pageInfo(PageInfo)REQUIRED
Information of the current page of a total list
count(Int)REQUIRED
Total counts of Pro Network Groups
edges(TopicEdge)REQUIRED
List of Topics

UpcomingEventsConnection

object
Fields:
pageInfo(PageInfo)REQUIRED
Information to aid in pagination
count(Int)REQUIRED
The total number of edges
edges(UpcomingEventsEdge)REQUIRED
A list of past events edges

UpcomingEventsEdge

object
Fields:
cursor(String)REQUIRED
Represents the position of the item inside the list of edges
node(Event)REQUIRED
Contains information about the event

UpdateGroupDraftPayload

object
The result of updating the group
Fields:
group(Group)
The group which has been updated
errors([PayloadError])
Null if updating was successful or array of errors if something gone wrong

UpdateGroupPayload

object
The result of operations with a group
Fields:
group(Group)
The group with which the operation was performed

UpdateGroupSettingsPayload

object
Fields:
groupSettings(GroupSettings)

User

object
Fields:
memberships(UserGroupsConnection)
memberships for user. Currently we only support memberships for the requesting member.
tickets(UserTicketsConnection)REQUIRED
id(ID)REQUIRED
Unique numeric identifier for the member
email(String)
Member email address. Provided only if a profile belongs to the authenticated member
name(String)
The name of the member
username(String)
birthday(DateTime)
Member photo. May be absent if member has not chosen one. In group contexts, the Member's Group profile photo will be returned.
memberPhoto(Image)
profilePhotos(MemberProfilePhotosConnection)REQUIRED
isAdmin(Boolean)
Returns true if the member is an active admin of an active Meetup group or Pro network
isOrganizer(Boolean)
hostedEvents(RootEventsConnection)REQUIRED
Events which are hosted by currently authenticated user
upcomingEvents(RootEventsConnection)REQUIRED
Upcoming events from the groups you belong to
hasDraftEvents(Boolean)REQUIRED
Whether the user has at least one event draft
draftEvents(RootEventsConnection)REQUIRED
Requests two last draft events created by current user
savedEvents(RootEventsConnection)REQUIRED
Events which are saved by currently authenticated user
lat(Float)
Latitude currently authenticated user
lon(Float)
Longitude currently authenticated user
city(String)
The city of the currently authenticated user
state(String)
The state of the currently authenticated user
zip(String)
The zip code of the currently authenticated user
country(String)
The country of the currently authenticated user
joinTime(DateTime)
Time the member joined, represented as milliseconds since the epoch
preferredLocale(String)
Preferred locale of the currently authenticated user
memberUrl(String)REQUIRED
Represents a link to the member on meetup.com
bio(String)
The member's biography
subscriptionProfile(SubscriptionProfile)
An organizer subscription configuration available to a member. Can only be viewed by self.
subscriptionSummary(SubscriptionSummary)
An organizer subscription summary available to a member. Can only be viewed by self.
isNew(Boolean)
Indicator to determine if the user is new or not
stripeCustomerId(String)
Unique Stripe identifier for the member
isLeader(Boolean)
Returns true if user is an Organizer, Co-Organizer, Assistant Organizer, or Event Organizer in any group
highestCurrentRole(MemberRole)
Highest role that member possesses across all their groups
isProOrganizer(Boolean)
Is on the leadership team of a pro group
isProPrimaryOrganizer(Boolean)REQUIRED
Is a primary organizer of a pro group
hasAcceptedLatestTerms(Boolean)
Whether the user has accepted the latest version of T&C
onboardingEvents(OnboardingEventsConnection)REQUIRED
recommendedTopics(TopicsConnection)REQUIRED
A list of recommended topics to add
timezone(String)
User's timezone
bestPromotion(BestPromotion)
The best promotion (discount or trial) currently available to a member
commonGroups(UserCommonGroupsConnection)
A list of common groups
zoomAuthorization(ZoomAuthorization)
Zoom authorization status
stepUpGroups(UserStepUpGroupsConnection)REQUIRED
Potentials step up groups
organizedGroupCount(Int)REQUIRED
A number of groups where member is a primary organizer
recommendedGroups(RecommendedGroupsPayload)REQUIRED
A list of recommended groups
preferences(Preference)REQUIRED
temporaryPreferences(Preference)REQUIRED
Temporary user preferences which expire over time
status(MemberStatus)
The status of the member
gender(MemberGender)
The gender of the member
experiments(ExperimentPayload)REQUIRED
Enrollment information for the requested experiments (split tests).
devices(MemberDevice)REQUIRED
Connected member devices
adminProNetworks(ProNetwork)REQUIRED
calendarExportUrls(MemberCalendarExportUrls)REQUIRED
A collection of links a member can use to export their events to external calendars
chatSessionToken(String)
User session token for event chat
profilePrivacy(ProfilePrivacy)
applicationAuthorizations(ApplicationAuthorizationConnection)REQUIRED
A list of application authorizations. Could be filtered by the application type
fundraising(MemberFundraising)
Information specific to the member about fundraising. This field may be null in cases where the member has no organized groups
eventFeesPaymentsMade(EventFeesPaymentsMadeListConnection)REQUIRED
List of event fees payments made
duesPaymentsMade(DuesPaymentsMadeListConnection)REQUIRED
List of dues payments made
paymentsHistory(PaymentsHistoryConnection)REQUIRED
Member payments history
adsData(AdsData)
A summary of information for ad targetting
chats(ChatsConnection)REQUIRED
chats that user is a member of
starbucksInfo(StarbucksInfo)
Starbucks related metadata if user is Starbucks employee
notifications(UserNotificationsConnection)

UserGroupsConnection

object
List of groups where the user is a member with pagination
Fields:
pageInfo(PageInfo)REQUIRED
Information of the current page of a total list
activeEventGroup(Group)
A group with an soon to start, happening, or just finished event that this member is hosting
count(Int)REQUIRED
Total count of groups where the user is a member
edges(UserGroupsEdge)REQUIRED
List of groups where the user is a member

UserGroupsEdge

object
An item of the list of groups where the user is a member
Fields:
cursor(String)REQUIRED
Represents the position of the item inside the list of edges
node(Group)REQUIRED
Contains information about the actual item
metadata(GroupMembership)
Additional information about membership in the group

UserNotificationsConnection

object
Fields:
pageInfo(PageInfo)REQUIRED
count(Int)REQUIRED
unreadCount(Int)
edges(UserNotificationsEdge)REQUIRED

Venue

object
Fields:
id(ID)REQUIRED
name(String)
address(String)
city(String)
state(String)
postalCode(String)
crossStreet(String)
country(String)
lat(Float)REQUIRED
lng(Float)REQUIRED

Enums

BillIntervalUnit

enum
A subscription billing interval.
Values:
MONTHS
DAYS

ContentType

enum
Values:
PNG
JPEG
GIF

CovidPrecautionMaskPolicy

enum
Values:
NOT_REQUIRED
REQUIRED

CovidPrecautionVaccinePolicy

enum
Values:
NOT_REQUIRED
REQUIRED

CovidPrecautionVenueType

enum
Values:
INDOORS
OUTDOORS
NONE

Currency

enum
List of supported currencies
Values:
USD
CAD
EUR
AUD
GBP
BRL
INR
JPY
RUB
KRW
CHF
PLN
THB
TRY

DayOfWeek

enum
Values:
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

EventAnnounceStatus

enum
Values:
UNANNOUNCED
SENDING
ANNOUNCED

EventPriceTier

enum
The price tier of the event
Values:
FREE
PAID

EventStatus

enum
The status of the event
Values:
PUBLISHED
DRAFT
CANCELLED
CANCELLED_PERM
AUTOSCHED
ACTIVE
PAST

EventTimeStatus

enum
The time status of the event
Values:
UPCOMING
BEGUN
ENDED

EventType

enum
Type of event
Values:
ONLINE
The event takes place online
PHYSICAL
The event takes place in-person

EventVenueVisibility

enum
Values:
GROUP
The event venue is visible only for group members
PUBLIC
The event venue is visible for all

EventsSortField

enum
events() type only supports sorting on EVENT_DATE (default) at this time
Values:
EVENT_DATE

FeeType

enum
Type of fee
Values:
FLAT
PERCENT

GroupBoardsMode

enum
Values:
OFF
ON
READONLY

GroupJoinMode

enum
Controls how members are let into the group
Values:
APPROVAL
Members must be approved by an organizer
CLOSED
The group is not currently accepting new members
OPEN
Any meetup member can join

GroupMailingListMode

enum
Values:
OFF
ORGS_ONLY
MODERATED
OPEN

GroupPrivacy

enum
Values:
PUBLIC
PRIVATE

HappeningFilter

enum
Represents when the event is taking place, used for filtering
Values:
FUTURE
The event takes place in the future
PAST
The event took place in the past

KeywordSortField

enum
How should be sorted results of the search
Values:
RELEVANCE
Results will be sorted by relevance
DATETIME
Results will be sorted by datetime

MemberRole

enum
Values:
ORGANIZER
Is an organizer of at least one of the groups in a network
COORGANIZER
Is a co-organizer of at least one of the groups in a network
ASSISTANT_ORGANIZER
Is an assistant of at least one of the groups in a network
EVENT_ORGANIZER
Is an event organizer of at least one of the groups in a network
MEMBER
Is an ordinary member of a group in the Pro Network

MembershipRole

enum
The role of a user in the group
Values:
MEMBER
ORGANIZER
COORGANIZER
ASST_ORGANIZER
EVENT_ORGANIZER

MembershipStatus

enum
The status of membership in the group
Values:
PENDING_PAYMENT
GROUP_BLOCKED_ORG
GROUP_BLOCKED
ABANDONED
DEAD
BOOTED
BOUNCED
UNAPPROVED
REMOVED
BLOCKED
INCOMPLETE
PENDING
ACTIVE
LEADER
Leaders are Organizers, Co-Organizers, Assistant Organizers, OR Event Organizers

NetworkUsersSortField

enum
Values:
JOIN_TIME
Sort by date when member joined the network
LAST_ACCESS_TIME
Sort by last access time field
MEMBER_NAME
Sort by members names

OnlineVenueType

enum
The venue type of an online event
Values:
GOOGLEHANGOUT
ZOOM
SKYPE
OTHER

PaymentMethod

enum
Values:
CASH
PAYPAL

PhotoType

enum
Values:
GROUP_PHOTO
EVENT_PHOTO
ALBUM_PHOTO
MEMBER_PHOTO
SPONSOR_LOGO
NETWORK_LOGO
NETWORK_BG
PRO_BULK_GROUP_PHOTO

ProNetworkEventStatus

enum
Status of the proEvent
Values:
UPCOMING
The event is upcomming
PAST
The event is PAST
CANCELLED
The event is cancelled

ProNetworkEventsSortField

enum
Values:
TITLE
Sort by event title
DATE_TIME
Sort by dateTime field. Default field for sorting
TICKETS_COUNT
Sort by tickets count

ProNetworkStatus

enum
Status of the network
Values:
ACTIVE
The network is active
INACTIVE
The network is inactive
FROZEN
The network is frozen

RsvpState

enum
Values:
NONE
The default of invalid state
RSVP
User is able to RSVP to the event
FULL
The event is full
DUES
The event requires dues or the public group requires dues
EXTERNAL_YES
The user has RSVP'd 'yes' to event with external RSVP
YES
The user has RSVP'd 'yes'
NO
The user has RSVP'd 'no'
WAITLIST
The user is on the waitlist
CLOSED
RSVPs for the event are closed
NOT_OPEN_YET
RSVPs for the event are not open yet
PAST
The event is past
CANCELLED
The event has been cancelled
JOIN_DUES_APPROVAL
User needs to join the group and pay dues before RSVPing
JOIN_OPEN
User needs to join the group before RSVPing
JOIN_APPROVAL
User needs to join the group and be approved before RSVPing
REQUESTED
User has requested to join the group and is waiting approval

RsvpStatus

enum
Values:
YES
A member's response expressing an intent to attend
NO
A member's response expressing they won't attend
WAITLIST
A member's response expressing an intent to attend to an over capacity event
MAYBE
No longer supported
ATTENDED
An organizer confirmed attendance
NO_SHOW
An organized flagged RSVP for a member that was expected to attend but didn't
HAVENT
An unresponded to RSVP
EXCUSED_ABSENCE
A organizer confirmed absence
YES_PENDING_PAYMENT
A member's expressed intent to go to an paid event before payment has been processed

RsvpSurveyQuestion

enum
Values:
FIRST_NAME
LAST_NAME
COMPANY
TOPIC
ROLE

SavedEventsFilter

enum
Values:
ALL
FUTURE
PAST

SearchSources

enum
Where should be search be done
Values:
EVENTS
Search will be done among events
GROUPS
Search will be done among groups

SocialNetworkService

enum
Social network service type enum.
Values:
FACEBOOK
TWITTER
FLICKR
TUMBLR
INSTAGRAM
LINKEDIN
OTHER

SocialNetworkStatus

enum
Values:
ACTIVE
HIDDEN

SortOrder

enum
The sort order used for ordering lists of objects
Values:
ASC
The sort order is ascending
DESC
The sort order is descending

SubscriptionProfileDiscountDuration

enum
A subscription discount duration.
Values:
ONCE
A discount is applied only to the first subscription charge.
FOREVER
A discount is applied to each subscription charge (start and renewals).

TicketStatus

enum
Values:
YES
NO
WAITLIST
MAYBE
ATTENDED
NO_SHOW
HAVENT
EXCUSED_ABSENCE
YES_PENDING_PAYMENT

Scalars

Boolean

The `Boolean` scalar type represents `true` or `false`.

DateTime

Duration

A time-based amount of time, such as "34.5 seconds"

Float

The `Float` scalar type represents signed double-precision fractional values as specified by [IEEE 754](https://en.wikipedia.org/wiki/IEEE_floating_point).

ID

The `ID` scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as `"4"`) or integer (such as `4`) input value will be accepted as an ID.

Int

The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

String

The `String` scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

ZonedDateTime

A specific moment in time, such as 2018-07-01T12:00:00-04:00, serialized in ISO8601 format

Interfaces

Connection

object
A paginated field on an object
Fields:
pageInfo(PageInfo)REQUIRED
Information to aid in pagination
count(Int)REQUIRED
The total number of edges
edges(Edge)REQUIRED
A list of edges

Edge

object
Metadata about one object in a paginated list. Includes a cursor to allow pagination starting from that object
Fields:
cursor(String)REQUIRED
Represents the position of the item inside the list of edges
node(Node)REQUIRED
Contains information about the actual item

Node

object
An object with an ID to support global identification
Fields:
id(ID)REQUIRED
A unique alphanumeric identifier

Inputs

AddGroupToNetworkByUrlnameInput

object
Fields:
networkUrlname(String)REQUIRED
Urlname of Pro Network where the group will be added to
groupUrlname(String)REQUIRED
Urlname of the group which will be added to Pro Network

AddGroupToNetworkInput

object
Fields:
networkId(ID)REQUIRED
Pro Network Id where the group will be added to
groupId(ID)REQUIRED
Id of the group which will be added to Pro Network

AnnounceEventInput

object
Data for announcing the event
Fields:
eventId(ID)REQUIRED
Alphanumeric identifier for the event

CloseEventRsvpsInput

object
Data for closing the event RSVP
Fields:
eventId(ID)REQUIRED
Alphanumeric identifier for the event

ConnectionInput

object
Fields:
first(Int)
Returns up to the first n elements from the list
last(Int)
Returns up to the last n elements from the list
after(String)
Returns the elements that come after the specified cursor
before(String)
Returns the elements that come before the specified cursor
reverse(Boolean)
Reverse the order of the underlying list

CreateEventInput

object
Fields:
groupUrlname(String)REQUIRED
title(String)REQUIRED
String setting the name of the event. Must be at least 1 character and may not be longer than 80 characters.
description(String)REQUIRED
String setting the description of the event, in simple HTML format. May not be longer than 50000 characters.
startDateTime(DateTime)REQUIRED
Field representing event start time without timezone data. The date will be scheduled in the Group's timezone. Example 2022-03-01T05:30
duration(Duration)
Duration, Should be according to the ISO 8601 duration specified format
rsvpSettings(RsvpSettings)
Representing rsvp settings (open/close time etc.)
eventHosts([Int])
List of valid member ids who will be hosts of the event. This defaults to the authenticated member when self_rsvp is true or undefined.
venueId(String)
Representing a numeric identifier for a venue. For online events use the string alias 'online'. To unset this field, provide a value of "0"
venueVisibility(EventVenueVisibility)
Field indicating whether the event venue and host location description will be visible to non-members of the hosting group.
selfRsvp(Boolean)
Boolean value indicating whether the authenticated member will be RSVP'd to the event upon creation. This defaults to true.
howToFindUs(String)
String setting the description for the location of the host(s) at the event venue. For online events this field is used for the event's url. To unset this field, provide an empty string
location(PointLocation)
Representing adjusted venue latitude and longitude
question(String)
String setting the RSVP survey question for the event. May not be longer than 250 characters. To unset this field, provide an empty string
feeOption(EventFeeOption)
Representing attributes for paid events
recurring(RecurringEvents)
Representing attributes to schedule recurring event
featuredPhotoId(Int)
Positive integer representing a numeric identifier for a photo, which must be one associated with this group. When undefined or 0, no photo is set.
rsvpSurvey(RsvpSurvey)
Representing attributes survey questions which will be available for Pro admins
topics([ID])
Topic ids to associate with the eveent
covidPrecautions(CovidPrecautionsInput)
List of hosted defined precautions for COVID 19
fundraising(EventFundraisingInput)
Settings pretaining to fundraising for this event
publishStatus(PublishStatus)
Indicates whether an event will be published to the group or as a draft visible only to the leadership team. This defaults to "PUBLISHED".
proNetworkEvents(ProNetworkEventsInput)
Pro Network Event settings
zoomMeetingId(ID)
A Zoom meeting ID if the event is online and uses Zoom integration.
isCopy(Boolean)
Flag that indicates if this event is being copied from another event
templateId(ID)
Template Id to store a mapping between the event and the template

CreateGroupDraftInput

object
Initial data for creating a draft of the group
Fields:
name(String)REQUIRED
Display name of the group. Can be at most 60 characters
description(String)REQUIRED
Summary of what the Meetup group is about in simple HTML format
customMembersLabel(String)
What members of the group will be called. Can be at most 32 characters
topics([ID])
Sets the specified topics to the group overwriting any existing topics. Topics are identified by ids and can be obtained from find topics query
urlname(String)
Name used for the group's web address on meetup.com. Must be between 6 and 60 characters
location(GroupLocation)
Group Location

CreateVenueInput

object
Fields:
groupId(ID)
name(String)REQUIRED
address(String)REQUIRED
city(String)REQUIRED
country(String)REQUIRED
lower case two character country code
state(String)
if country us us or ca, state is required otherwise it may be omitted

DeleteEventInput

object
Data for deleting the event RSVP
Fields:
eventId(ID)REQUIRED
Alphanumeric identifier for the event
removeFromCalendar(Boolean)
True if the event should be removed from calendar
updateSeries(Boolean)
True if whole series of the event should be deleted

EditEventInput

object
Data for editing the event
Fields:
eventId(ID)REQUIRED
Identifier of event which will be edited
title(String)
String setting the name of the event. Must be at least 1 character and may not be longer than 80 characters.
description(String)
String setting the description of the event, in simple HTML format. May not be longer than 50000 characters.
startDateTime(DateTime)
Field representing event start time
applyToSeries(Boolean)
Whether changes should be applied to series of events
duration(Duration)
Duration, Should be according to the ISO 8601 duration specified format
rsvpSettings(RsvpSettings)
Representing rsvp settings (open/close time etc.)
eventHosts([Int])
List of valid member ids who will be hosts of the event. This defaults to the authenticated member when self_rsvp is true or undefined.
venueId(String)
Representing a numeric identifier for a venue. For online events use the string alias 'online'.
venueVisibility(EventVenueVisibility)
Field indicating whether the event venue and host location description will be visible to non-members of the hosting group.
howToFindUs(String)
String setting the description for the location of the host(s) at the event venue. For online events this field is used for the event's url.
location(PointLocation)
Representing adjusted venue latitude and longitude
question(String)
String setting the RSVP survey question for the event. May not be longer than 250 characters.
feeOption(EventFeeOptionEdit)
Representing attributes for paid events
recurring(RecurringEventsEdit)
Representing attributes to schedule recurring event
featuredPhotoId(Int)
Positive integer representing a numeric identifier for a photo, which must be one associated with this group. When undefined or 0, no photo is set.
rsvpSurvey(RsvpSurveyEdit)
Representing attributes survey questions which will be available for Pro admins
topics([ID])
Topic ids to associate with the event
covidPrecautions(CovidPrecautionsInput)
List of hosted defined precautions for COVID 19
fundraising(EventFundraisingInput)
Settings pretaining to fundraising for this event
publishStatus(PublishStatus)
Indicates whether an event will be published to the group or as a draft visible only to the leadership team. This defaults to "PUBLISHED".
proNetworkEvents(ProNetworkEventsInput)
Pro Network Event settings
zoomMeetingId(ID)
Zoom meeting id. Zoom meeting will be removed from the event if id isn't provided.

EventFeeOption

object
Options for fee of the event
Fields:
paymentMethod(PaymentMethod)REQUIRED
String representing the payment method for the event fee if a fee is charged for the event
currency(Currency)REQUIRED
String representing the currency for the event fee if a fee is charged for the event.
amount(Int)REQUIRED
Representing the amount of the event fee if a fee is charged for the event.
refundPolicy(String)
String setting the refund policy if the event has a fee. May not be longer than 250 characters.
paypalEmail(String)
Paypal email

EventFeeOptionEdit

object
Fields:
enabled(Boolean)REQUIRED
If the event fee option editing is allowed
fee(EventFeeOption)
Fee options of the event

EventsFilter

object
Fields:
happening([HappeningFilter])
Time when the event happened (for filter results)

EventsSort

object
Input data for sorting
Fields:
sortOrder(SortOrder)
Sort order. Default: DESC
sortField(EventsSortField)
Attribute for sorting

ForwardConnectionInput

object
Fields:
first(Int)
Returns up to the first n elements from the list
after(String)
Returns the elements that come after the specified cursor

GeoLocation

object
The geographical place
Fields:
country(String)
The ISO_3166-1 country code for the country which contains the city
zip(String)
The ZIP code of the city

GroupAnalyticsFilter

object
Fields:
activeWithinDays(Int)
including only those groups that had event in the last specified days
categories([ID])
the ids of the category of the group
groupsUrlnames([String])
the urlnames of chapters that may belong to the organization
groups([ID])
the grops ids that may belong to the organization
country(String)
Country
latitude(Float)
Latitude
longtitude(Float)
Longitude
radius(Float)
Search radius in miles
zip(String)
Zip code
active(Boolean)
only active groups if true, only delisted if false
inactiveWithinDays(Int)
including only those groups that did not have event in the last specified days
lastEventMax(DateTime)
Maximum range of the date that the last meetup happened
lastEventMin(DateTime)
Minimum range of the date that the last meetup happened
memberCountMax(Int)
Maximum range of the number of members
memberCountMin(Int)
Minimum range of the number of members
name(String)
Name of the group looking for
nextEventMax(DateTime)
Maximum range of the date that the next meetup is scheduled
nextEventMin(DateTime)
Minimum range of the date that the next meetup is scheduled
pastEventsMax(Int)
Maximum range of the number of the past events held
pastEventsMin(Int)
Minimum range of the number of the past events held
proJoinDateMax(DateTime)
Maximum range of the dates the groups joined Pro organization
proJoinDateMin(DateTime)
Minumum range of the dates the groups joined Pro organization
repeatRsvpersMax(Int)
Maximum range of the average number of repeat rsvpers
repeatRsvpersMin(Int)
Minimum range of the average number of repeat rsvpers
upcomingEventsMax(Int)
Maximum range of the number of the upcoming events
upcomingEventsMin(Int)
Minimum range of the number of the upcoming events

GroupLocation

object
Group Location (if any is provided, the other one is required)
Fields:
pointLocation(PointLocation)
geoLocation(GeoLocation)

GroupQuestionInput

object
Fields:
id(ID)REQUIRED
question(String)REQUIRED
sort(Int)REQUIRED

GroupUpcomingEventsFilter

object
Filter for upcoming events
Fields:
includeCancelled(Boolean)
When true, include upcoming cancelled events. Defaults to false
myEvents(Boolean)
A boolean value to filter events which member RSVPed on DEPRECATED: this is no longer supported

ImageUploadInput

object
Input parameters for uploading the image
Fields:
groupId(ID)REQUIRED
Id of the group, where the image will be attached to
photoType(PhotoType)REQUIRED
The type of the image (for an event or for a group)
fileName(String)REQUIRED
The file name of the image
contentType(ContentType)REQUIRED
ContentType is used to indicate the media type of the resource

KeywordSort

object
Only DESC order is supported at the moment
Fields:
sortOrder(SortOrder)
Order of sorting
sortField(KeywordSortField)
Field for sorting

MembershipFilter

object
Filter by status of the group member
Fields:
status([MembershipStatus])
The status of the group member
groupStatus([GroupStatus])
The status of the group
onlyDues(Boolean)
Dues only groups
onlyApprovedGroups(Boolean)
If set only groups that have been approved in NGQ are returned in the response.

NetworkUsersFilter

object
Fields:
activeWithinDays(Int)
The range of date from the past until today, for the recent activity
groups([ID])
The groups which the member belongs to
country(String)
Country
eventsAttendedMax(Int)
Maximum number of attended events
eventsAttendedMin(Int)
Minimum number of attended events
roles([MemberRole])
List of member roles to search by
joinDateTimeMax(DateTime)
The latest time limit for member join
joinDateTimeMin(DateTime)
The oldest time limit for member join
latitude(Float)
Latitude
longitude(Float)
Longitude
userName(String)
Name of the member
query(String)
raw query string to search from member name or city
radius(Float)
Search radius in miles
zip(String)
Zip code
users([ID])
The member ids that may belong to the organization
excludedUsers([ID])
The members to exclude from result
canReceiveEmails(Boolean)
Searching only the members who can or cannot receive mass email

NetworkUsersSort

object
Fields:
sortField(NetworkUsersSortField)
Attribute for sorting
sortOrder(SortOrder)
Sort order. Default: DESC

OpenEventRsvpsInput

object
Data for opening the event RSVP
Fields:
eventId(ID)REQUIRED
Alphanumeric identifier for the event

PointLocation

object
The place as a point on a map with coordinates
Fields:
latitude(Float)REQUIRED
Latitude of the city
longitude(Float)REQUIRED
Longitude of the city

ProNetworkEventsFilter

object
Fields:
title(String)
Title of the event
isOnlineEvent(Boolean)
Whether event is online
radius(Float)
Radius in miles
lat(Float)
Latitude
lon(Float)
Longitude
zip(String)
Zip code
country(String)
Location country
query(String)
Raw query to search by event title and host name
status(ProNetworkEventStatus)
Pro event status
groups([ID])
Groups ids that belong to network organization
eventDateMin(DateTime)
Minimum range of the event dates in the network (ISO 8601 date)
eventDateMax(DateTime)
Maximum range of the event dates in the network (ISO 8601 date)
rsvpsPerEventMax(Int)
Maximum range of the average number of RSVPs per event
rsvpsPerEventMin(Int)
Maximum range of the average number of RSVPs per event
excludedGroups([ID])
the chapters to exclude from the result
hosts([ID])
The member ids of the hosts

ProNetworkEventsSort

object
Parameters for sorting
Fields:
sortField(ProNetworkEventsSortField)
Attribute for sorting
sortOrder(SortOrder)
Sort order. Default: DESC

PublishEventDraftInput

object
Data for publishing the event
Fields:
eventId(ID)REQUIRED
Alphanumeric identifier for the event

PublishGroupDraftInput

object
Input data for publishing the group
Fields:
token(String)REQUIRED
Group draft token
ticketId(ID)
Id of a ticket issued by a Pro network sponsoring the organizer.

RecurringEvents

object
Fields:
weeklyRecurrence(WeeklyRecurrence)
monthlyRecurrence(MonthlyRecurrence)
endDate(String)
An ISO date in the form `YYYY-MM-DD` or `2011-12-03`

RecurringEventsEdit

object
Fields:
enabled(Boolean)REQUIRED
If the recurring events editing is allowed
settings(RecurringEvents)
Parameters of recurring events

RsvpSettings

object
Fields:
rsvpOpenTime(DateTime)
Field representing the time after which members will be allowed to RSVP to the event in milliseconds since the epoch. This can only be set if there is a start time for the event. This defaults to no RSVP open time restriction. To remove the RSVP open time from an existing event, set rsvpOpenDuration to PT0S
rsvpCloseTime(DateTime)
Field representing the time before which members will be allowed to RSVP to the event in milliseconds since the epoch. This can only be set if there is a start time for the event. This defaults to no RSVP close time restriction. To remove the RSVP close time from an existing event, set rsvpCloseDuration to PT0S
rsvpOpenDuration(Duration)
Duration, Should be according to the ISO 8601 duration specified format To remove the RSVP open time from an existing event, set rsvpOpenDuration to PT0S
rsvpCloseDuration(Duration)
Duration, Should be according to the ISO 8601 duration specified format To remove the RSVP close time from an existing event, set rsvpCloseDuration to PT0S
rsvpLimit(Int)
Positive integer representing total number of RSVP slots available for the event. When undefined or defined as 0, there will be no set limit. To remove the RSVP limit from an existing event, provide a value of 0
guestLimit(Int)
Positive integer representing the number of guests that members may include in their RSVP, 0 inclusive. This defaults to 2.

RsvpSurvey

object
Fields:
sponsorName(String)
sponsorUrl(String)
questions(RsvpSurveyQuestion)REQUIRED

RsvpSurveyEdit

object
Fields:
enabled(Boolean)REQUIRED
If the RSVP survey editing is allowed
survey(RsvpSurvey)
The RSVP survey

SearchConnectionFilter

object
Fields:
query(String)REQUIRED
A pattern string for searching by occurrence in a group name or an event title
lat(Float)REQUIRED
Latitude of the location of an event or a group
lon(Float)REQUIRED
Longtitude if the location of an event or a group
source(SearchSources)REQUIRED
Where to look data, among events or groups
startDateRange(ZonedDateTime)
The earleast date of event
endDateRange(ZonedDateTime)
The latest date of event
eventType(EventType)
Type of event: online or not
radius(Int)
The search radius relative to location
categoryId(Int)
ID of the event category
topicCategoryId(Int)
The id of topicCategory [from topic taxonomy]
isHappeningNow(Boolean)
Whether the event is in progress
isStartingSoon(Boolean)
city(String)
state(String)
country(String)
zip(String)
cityLocations([CityLocation])
City Boroughs or Neighborhoods Locations

SocialNetworkInput

object
Fields:
identifier(String)REQUIRED
service(SocialNetworkService)REQUIRED
status(SocialNetworkStatus)REQUIRED

UpdateGroupDraftInput

object
Data for editiong a draft of the group
Fields:
token(String)REQUIRED
A token identifying a group draft
name(String)
Display name of the group. Can be at most 60 characters
description(String)
Summary of what the Meetup group is about in simple HTML format
customMembersLabel(String)
What members of the group will be called. Can be at most 32 characters
topics([ID])
Sets the specified topics to the group overwriting any existing topics. Topics are identified by ids and can be obtained from find topics query
urlname(String)
Name used for the group's web address on meetup.com. Must be between 6 and 60 characters
location(GroupLocation)
Group Location

UpdateGroupInput

object
Fields that can be changed in a group with an update mutation.
Fields:
id(ID)REQUIRED
Used to identify the group that will be mutated with this input
logoId(String)
The id of the logo image
name(String)
The name of the group
description(String)
The group description
customMemberLabel(String)
The label of member
country(String)
Country where the main offline activity of group is happened
city(String)
City where the main offline activity of group is happened
state(String)
State where the main offline activity of group is happened
zip(String)
Zip code of the place where the main offline activity of group is happened
urlname(String)
urlname of group
coverPhotoId(Int)
Id of the cover image

UpdateGroupSettingsInput

object
Fields that can be changed in a group with an update mutation.
Fields:
id(ID)REQUIRED
Used to identify the group that will be mutated with this input
name(String)
description(String)
customMemberLabel(String)
country(String)
city(String)
zip(String)
urlname(String)
privacy(GroupPrivacy)
coverPhotoId(Int)
joinMode(GroupJoinMode)
needsPhoto(Boolean)
needsQuestions(Boolean)
questions([GroupQuestionInput])
welcomeBlurb(String)
mailingListMode(GroupMailingListMode)
listAddress(String)
feeCurrency(Currency)
boardsMode(GroupBoardsMode)
socialNetworks([SocialNetworkInput])
activeTopics([ID])
video(GroupVideoInput)
Group featured video.

WeeklyRecurrence

object
Fields:
weeklyInterval(Int)REQUIRED
Integer number of weeks between each recurrence
weeklyDaysOfWeek(DayOfWeek)REQUIRED
List days of the week this event will be hosted on

Unions

SearchNode

union
Possible types: