Skip to main content
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

  1. 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.
  2. 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.
  3. To apply Marketing Data to the number, include a custom_data property with pairs of Marketing Data field API names and their values.
  4. If the request is successful, the response includes information about the newly generated number.

​
Where to go next

Last modified on September 25, 2026