---
title: "Update a toll-free campaign"
method: PATCH
path: "/toll_free_campaigns/{campaign_id}"
tags: ["Toll-Free Campaigns"]
---

# Update a toll-free campaign

`PATCH /toll_free_campaigns/{campaign_id}`

## Request

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

Updates a toll-free campaign awaiting customer fixes and re-submits it for Surge review. Returns 409 if the campaign is not in an updatable status.

## Path parameters

- `campaign_id` string, required: The toll-free campaign ID to update.

## Request body

- TollFreeCampaignUpdateParams: Parameters for updating a toll-free campaign.
  - `consent_flows` union[]
    - 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: An explanation of how the toll-free number will be used.
  - `includes` string[]
  - `message_samples` string[]
  - `privacy_policy_url` string, uri
  - `terms_and_conditions_url` string, uri
  - `use_cases` string[]

## Response `200`

Updated 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`: Campaign is not in an updatable status
- `default`: Error

## Changes

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

[Operation history](https://skmtc.dev/surgeapi/apis/surge/changes/toll_free_campaigns/:campaign_id/patch.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)