addressalign-toparrow-leftarrow-rightbackbellblockcalendarcameraccwcheckchevron-downchevron-leftchevron-rightchevron-small-downchevron-small-leftchevron-small-rightchevron-small-upchevron-upcircle-with-checkcircle-with-crosscircle-with-pluscontroller-playcredit-cardcrossdots-three-verticaleditemptyheartexporteye-with-lineeyefacebookfolderfullheartglobe--smallglobegmailgooglegroupshelp-with-circleimageimagesinstagramFill 1languagelaunch-new-window--smalllight-bulblinklocation-pinlockm-swarmSearchmailmediummessagesminusmobilemoremuplabelShape 3 + Rectangle 1ShapeoutlookpersonJoin Group on CardStartprice-ribbonprintShapeShapeShapeShapeImported LayersImported LayersImported Layersshieldstartickettrashtriangle-downtriangle-uptwitteruserwarningyahooyoutube

Extend your community

Notifications

GET /notifications
  • json
Host: api.meetup.com
  • basic
api version 3

Returns all recent Meetup notifications for the authorized member. To mark notifications read use /notifications/read endpoint. To get the authenticated Member's current unread count, request it in an HTTP header.

Try it in the console

Request Parameters

No parameters are required

fields

Request that additional fields (separated by commas) be included in the output.

Response

The response includes a JSON-encoded list of current notification items.

category

Identifier indicating a high level categorization of related kinds.

This may be one of comment, default, event, group, money, photo

id

A unique identifier for a notification

important

True or False indicating a notification's level of importance

kind

Identifier indicating the kind of notification.

This may be one of attendance_reminder, comment, custom, donation_expire_notice, donation_potential_payment, dues, dues_confirm, dues_trial_notice, event_announce, event_announce_to_orgs, event_announce_untrusted, event_cancel, event_change, event_interest_org_push, event_reminder, external_url, final_attendance_reminder, group_announce, group_announce_push, invitation_acceptance, join, like, mug_comm_announce, mug_comm_comment, mug_comm_comment_like, mug_comm_conversation_like, mug_comm_invite, org_approve, outside_mup_rec, pending_member, photo, photo_tag, post_attendance, post_event_feedback, reply, rsvp, rsvp_confirm, saved_event_reminder, spot_open, webview_url

link

Link to resource notification was triggered by

photo

A photo related to the notifications. Potentially absent

base_url

A base url that can be use to construct a photo url from its components

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

type

Type of photo. One of "event" or "member"

photo_type

Type of photo, event or member

read

True or False indicating whether a notification has been read

self

Information pertaining the authorized member associated with this notification

action

An action that may be performed on this notification.

For group_announce notifications this may be 'instant_join', meaning the group associated with the notification may be joined without filling out profile information, or 'form_join', the group associated with the notification requires some join information.

event_announce and spot_open notifications this may be 'instant_rsvp', meaning the event may be RSVP'd to without requiring additional input, or 'form_rsvp', meaning the event may require some input on the current member's behalf before RSVPing.

For event_reminder notifications this may be 'instant_rsvp' if recipient is a non-rsvper or 'instant_rsvp_no' if recipient is a yes rsvper.

For pending_member notifications this may be 'approve_member'.

setting

The setting that controls the member's preference for receiving sendings of this kind of notification

email

A push setting if available

name

display code

push

An email setting if available

name

display code

target

kind specific properties which may be used to navigate back to the source of the notification

album_id

If needed, a numeric photo album ID

comment_id

If needed, the numeric ID of the comment which relates to this notification

comment_parent_id

If needed, the numeric ID of the top-level comment which relates to this notification

event_id

If needed, the alphanumeric ID of the event which relates to this notification

group_id

If needed, the numeric ID of the group which relates to this notification

group_urlname

If needed, the alpha numeric urlname of the group which relates to this notification

member_id

If needed, the numeric ID of the member involved in the notification

pending

If needed, a boolean valid indicating the membership status of member_id in the context of a group

photo_id

If needed, a numeric photo ID

type

Identifier indicating the view that should be navigated to.

These may be one of: group, group_member_list, group_member_profile, event, topic_picker, calendar, group_list, event_photos, event_comments, friends_calendar, friends_groups, start_group, external_url, event_location, deeplink_url

text

Notification content as text

updated

The last time the notification was modified, indicated as the time in milliseconds since the epoch

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated