> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invoca.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Create Static Promo Numbers via API

> 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

* [Can I Retrieve All Promo Numbers via the Network API?](/s/article/retrieve-all-promo-numbers-via-api)
* [Adding Local Promo Numbers](/s/article/adding-local-promo-numbers)