Static promo numbers (toll-free or local) can be automatically generated via the Invoca API — useful when you need to create several at once for a campaign.
Static promo numbers (toll-free or local) can be automatically generated via the Invoca API — useful when you need to create several at once for a campaign, rather than one at a time in the platform.
Applies to: Invoca API > Network Integration > Promo Numbers
Steps
-
Use the POST method with one of two endpoints:
/promo_numbers_by_id — if you want to specify the ID for the promo number yourself/promo_numbers.json — if you’re fine with an auto-generated ID
Replace the network ID, advertiser ID, and campaign ID in the endpoint URL with your own. Include an OAuth token as the oauth_token parameter.
-
Include the promo number’s properties in the request body as JSON. The required properties are
media_type and description.
- To create a local number, include a
local_center key with a zipcode, or city and state together.
- If you don’t include location information, a toll-free number is generated instead.
-
To apply Marketing Data to the number, include a
custom_data property with pairs of Marketing Data field API names and their values.
-
If the request is successful, the response includes information about the newly generated number.
Last modified on September 30, 2026
