Create a new special
Allows you to create a new special. As of November 2013, mayor, regular, swarm, friends, and flash specials are deprecated.
Requires Acting UserYes (learn more)
User RestrictionsMust be venue manager
Modes supportedfoursquare (learn more)
All parameters are optional, unless otherwise indicated.
nameMayor SpecialA name for the special.
textCongrats, as the Mayor, you get a free side!Required. Maximum length of 200 characters.
finePrintDoes not include fries.Maximum length of 200 characters. Fine print, shown in small type on the special detail page.
count15Specifier for special types.
typefrequencyRequired. The type of special.
frequencyCheck-in Special if count1 is 1; otherwise a Loyalty Specialunlocked every count1 check-ins
countNewbie Special if count1 is 1; otherwise a Loyalty Specialunlocked on the count1th check-in (all-time)
offerId5000000Maximum length of 16 characters. Internal id in your 3rd party system.
cost5.50The amount of money the user must spend to use this special in dollars and cents. For example, 5.50 meaning 5 dollars and 50 cents.
Response fields
specialA special object.