Toll-Free Campaigns

Update a toll-free campaign

Changed on

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.

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

Path parameters

campaign_idstring required

The toll-free campaign ID to update.

Example:tfc_01j9a43avnfqzbjfch6pygv1td

Request body

descriptionstring

An explanation of how the toll-free number will be used.

includesstring[]
message_samplesstring[]
privacy_policy_urlstring uri
terms_and_conditions_urlstring uri
use_casesstring[]

Response

Updated toll-free campaign

descriptionstring nullable required
idstring required

The toll-free campaign ID

includesstring[] required
message_samplesstring[] required
phone_number_idstring required

The toll-free phone number ID

privacy_policy_urlstring uri nullable required
status'active' | 'canceled' | 'created' | 'in_review' | 'rejected' required

The current status of the toll-free campaign.

terms_and_conditions_urlstring uri nullable required
use_casesstring[] required

Changes