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

Group Photo Upload

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

Uploads a new Meetup Group photo. To change other Group settings use the Group Edit endpoint

Request Parameters

The request must be a POST of content-type multipart/form-data. The supplied photo will be added to the provided groups general photo album. If authenticating with OAuth, no parameters in the multipart form data should be included in the signature base string. You must be an organizer of the group in order to load a photo.

await

If true, this ensures a response will not be returned until the upload is accessible

group_id

Group ID for the target group. This may be used as an alternative to group_urlname

group_urlname

Group urlname. This may be used as an alternative to group_id

main

Set to 'true' to have this photo become the group's main photo. Set it to 'false' otherwise. Defaults to true

photo

The photo, encoded as multipart/form-data. The maximum file size allowed is 10MB

Response

When successful, this method responds with a status of "201 Created" and a Location header with the uploaded photo's URL. The response body contains the following elements in JSON or XML. Upon recieving the response, some photos may not be immediately accesible. If this is desirable, use the "await" request parameter

group_photo_id

Unique identifier of this photo

photo_url

Link to the uploaded group photo (same as in the Location header).

title

Request Completed

Examples

Upload a new primary group photo with curl

curl "https://api.meetup.com/2/group_photo" \
   -F "photo=@/path/to/photo.jpg" \
   -F "group_urlname=MY_GROUP" \
   -F "key=API_KEY"

API methods

v3 batch

v2 categories

v2 cities

v2 dashboard

v1 groups

v1 oembed

v1 topics

v2 deprecated