Add a Page Update

https://api.foursquare.com/v2/pageupdates/add
Broadcast an update as a page to followers of the page and associated venues. Venues can be specified either by the venueId, groupId or pageId (meaning all venues managed by the page) parameters. Broadcasts will show up on venue pages in our apps and website.

A broadcast must contain a shout and may contain a photo. The API enforces a rate limit of at most one broadcast sent by a given user to the same set of venues in 15 minutes. This rate may change and is stricter for larger sets of venues.
HTTP MethodPOST
Requires Acting UserYes (learn more)
Modes supportedfoursquare (learn more)
Parameters
All parameters are optional, unless otherwise indicated.
pageId23456required id of the page to associate with the broadcast. To find the page for a venue you can look at the page object in the venue response.
groupIdf8ea99941eThe venue group from which to broadcast an update.
venueIdf8ea99941eA venue from which to broadcast an update.
shout"Try our new summer dish!"Text associated with the broadcast. 160 characters max, 10 characters min.
photoIdf8ea99941eAn optional photo to attach to the broadcast. For a new photo, you should use the photo add endpoint and specify only the pageId parameter.
broadcasttwitterAdditional places to send the broadcast to. Accepts a comma-delimited list of values:
  • facebook share on facebook
  • twitter share on twitter
  • private just create the update without broadcasting to anyone
Response fields
pageUpdateA page update object.