---
title: "Create a toll-free campaign"
method: POST
path: "/accounts/{account_id}/toll_free_campaigns"
tags: ["Toll-Free Campaigns"]
---

# Create a toll-free campaign

`POST /accounts/{account_id}/toll_free_campaigns`

## Request

- Base URL: `https://api.surge.app`
- URL: `https://api.surge.app/accounts/{account_id}/toll_free_campaigns`
- Auth: HTTP bearer

Creates a toll-free campaign and submits it for Surge review.

## Path parameters

- `account_id` string, required: The account for which the toll-free campaign should be created.

## Request body

- TollFreeCampaignParams: Parameters for creating a toll-free campaign through Surge
  - `consent_flows` union[], required
    - union
      - object
        - `script` string, required
        - `type` 'verbal', required
      - object
        - `form_url` string, uri
        - `owner` 'brand' | 'platform', required
        - `screenshot` object
          - `reason` 'behind_login' | 'under_construction' | 'other', required
          - `reason_other` string
          - `urls` string[], required
        - `type` 'web_form', required
      - object
        - `file_urls` string[], required
        - `keywords` string[]
        - `type` 'text', required
      - object
        - `file_urls` string[], required
        - `type` 'paper_form', required
  - `description` string, required: An explanation of how the toll-free number will be used.
  - `includes` string[]
  - `message_samples` string[], required
  - `phone_number_id` string, required: The toll-free phone number to register.
  - `privacy_policy_url` string, uri, required
  - `terms_and_conditions_url` string, uri, required
  - `use_cases` string[], required

## Response `201`

Created toll-free campaign

- TollFreeCampaign: A toll-free campaign registration for a phone number.
  - `consent_flows` TollFreeCampaignConsentFlow[], required
    - union: A consent flow returned on toll-free campaign responses.
      - object
        - `script` string, required
        - `type` 'verbal', required
      - object
        - `form_url` string, uri, required
        - `type` 'web_form', required
      - object
        - `screenshot` object, required
          - `reason` 'behind_login' | 'under_construction' | 'other', required
          - `reason_other` string
        - `type` 'web_form', required
      - object
        - `keywords` string[]
        - `type` 'text', required
      - object
        - `type` 'paper_form', required
  - `description` string, nullable, required
  - `id` string, required: The toll-free campaign ID
  - `includes` string[], required
  - `message_samples` string[], required
  - `phone_number_id` string, required: The toll-free phone number ID
  - `privacy_policy_url` string, uri, nullable, required
  - `status` 'active' | 'canceled' | 'created' | 'in_review' | 'rejected', required: The current status of the toll-free campaign.
  - `terms_and_conditions_url` string, uri, nullable, required
  - `use_cases` string[], required

## Other responses

- `409`: Phone number already has a toll-free campaign
- `default`: Error

## Changes

- **2026-10-16** `912b2a3101fc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/surgeapi/apis/surge/changes/accounts/:account_id/toll_free_campaigns/post.md)

---

[API](https://skmtc.dev/surgeapi/apis/surge.md) - [All operations](https://skmtc.dev/surgeapi/apis/surge/llms.txt) - [OpenAPI document](https://skmtc.dev/surgeapi/apis/surge/revisions/bb534713d694?raw)