import Surge from '@surgeapi/node';const client = new Surge({ apiKey: process.env['SURGE_API_KEY'], // This is the default and can be omitted});const tollFreeCampaign = await client.tollFreeCampaigns.update('tfc_01j9a43avnfqzbjfch6pygv1td');console.log(tollFreeCampaign.id);
import os
from surge import Surge
client = Surge(
api_key=os.environ.get("SURGE_API_KEY"), # This is the default and can be omitted
)
toll_free_campaign = client.toll_free_campaigns.update(
campaign_id="tfc_01j9a43avnfqzbjfch6pygv1td",
)
print(toll_free_campaign.id)
require "surge_api"
surge = SurgeAPI::Client.new(api_key: "My API Key")
toll_free_campaign = surge.toll_free_campaigns.update("tfc_01j9a43avnfqzbjfch6pygv1td")
puts(toll_free_campaign)
{
"error": {
"message": "The requested resource could not be found.",
"type": "not_found"
}
}
{
"error": {
"message": "The requested resource could not be found.",
"type": "not_found"
}
}
Toll-free Campaigns
Update toll-free campaign
Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.
PATCH
/
toll_free_campaigns
/
{campaign_id}
JavaScript
import Surge from '@surgeapi/node';const client = new Surge({ apiKey: process.env['SURGE_API_KEY'], // This is the default and can be omitted});const tollFreeCampaign = await client.tollFreeCampaigns.update('tfc_01j9a43avnfqzbjfch6pygv1td');console.log(tollFreeCampaign.id);
import os
from surge import Surge
client = Surge(
api_key=os.environ.get("SURGE_API_KEY"), # This is the default and can be omitted
)
toll_free_campaign = client.toll_free_campaigns.update(
campaign_id="tfc_01j9a43avnfqzbjfch6pygv1td",
)
print(toll_free_campaign.id)
require "surge_api"
surge = SurgeAPI::Client.new(api_key: "My API Key")
toll_free_campaign = surge.toll_free_campaigns.update("tfc_01j9a43avnfqzbjfch6pygv1td")
puts(toll_free_campaign)
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Surge","colors":{"primary":"#8200ff","light":"#a684ff","dark":"#7f22fe"},"logo":{"light":"https://mintcdn.com/surge-67d47b03/1YdD2Aq20HHnJtCK/logo.svg?fit=max\u0026auto=format\u0026n=1YdD2Aq20HHnJtCK\u0026q=85\u0026s=fb53e91d462980a01e9b7c046c98f339","dark":"https://mintcdn.com/surge-67d47b03/1YdD2Aq20HHnJtCK/logo.svg?fit=max\u0026auto=format\u0026n=1YdD2Aq20HHnJtCK\u0026q=85\u0026s=fb53e91d462980a01e9b7c046c98f339"},"favicon":"https://mintcdn.com/surge-67d47b03/TCCrlfgdQylYa0Zn/favicon.png?fit=max\u0026auto=format\u0026n=TCCrlfgdQylYa0Zn\u0026q=85\u0026s=9026e6be7d30dc29237a92585de3ae74","api":{"openapi":"openapi.documented.json"},"navbar":{"links":[{"href":"mailto:support@surge.app","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://hq.surge.app"}},"footer":{"socials":{"x":"https://x.com/surgeapi","github":"https://github.com/surgeapi","linkedin":"https://www.linkedin.com/company/surgeapi"}},"seo":{"metatags":{"og:image":"https://surgemsg.com/images/surge-preview-9b01c93f5b24bb5128b47c354c371546.jpg?vsn=d"},"indexing":"navigable"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"surge-67d47b03","hasAudioNarration":false,"actualSubdomain":"surge-67d47b03","customDomains":["docs.surge.app"],"gitSource":{"type":"github","owner":"surgeapi","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aaae7802f98a5cbbdae4267","collectionId":"0e5f70d2-2f10-4a77-ba88-b304ffb0016b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aaae7802f98a5cbbdae4267"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeb73f27989d49305c68ac9","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":64},{"language":"default","tag":"Endpoints","count":45},{"language":"default","tag":"Documentation","count":38},{"language":"default","tag":"Webhooks","count":16},{"language":"default","tag":"Events","count":14},{"language":"default","tag":"Phone numbers","count":10},{"language":"default","tag":"SDKs","count":10},{"language":"default","tag":"Register your business","count":9},{"language":"default","tag":"Accounts","count":6},{"language":"default","tag":"Users","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-logo{height:2rem}"}],"page":{"pagePath":"api-reference/endpoint/toll-free-campaigns/update","slug":"/api-reference/endpoint/toll-free-campaigns/update","pageMetadata":{"title":"Update toll-free campaign","description":"Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.","openapi":"PATCH /toll_free_campaigns/{campaign_id}","href":"/api-reference/endpoint/toll-free-campaigns/update"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update toll-free campaign","description":"Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.","openapi":"PATCH /toll_free_campaigns/{campaign_id}","href":"/api-reference/endpoint/toll-free-campaigns/update"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Toll-Free Campaigns"],"responses":{"200":"6b898b1f-d9e7-4446-923c-10fc0824954d","409":"a4eef46e-90b9-4f69-9de2-c9d5b39bd46f","default":"cd048b66-f13a-4e60-81c5-50835d2268dd"},"description":"Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.","operationId":"UpdateTollFreeCampaign","parameters":["b41ff09d-ff0d-4827-9c65-397e5a542d5f"],"requestBody":"bf826b1e-5b51-4eb1-90b4-79c7052f9ec0","summary":"Update a toll-free campaign","x-codeSamples":[{"lang":"JavaScript","source":"import Surge from '@surgeapi/node';\n\nconst client = new Surge({\n apiKey: process.env['SURGE_API_KEY'], // This is the default and can be omitted\n});\n\nconst tollFreeCampaign = await client.tollFreeCampaigns.update('tfc_01j9a43avnfqzbjfch6pygv1td');\n\nconsole.log(tollFreeCampaign.id);"},{"lang":"Python","source":"import os\nfrom surge import Surge\n\nclient = Surge(\n api_key=os.environ.get(\"SURGE_API_KEY\"), # This is the default and can be omitted\n)\ntoll_free_campaign = client.toll_free_campaigns.update(\n campaign_id=\"tfc_01j9a43avnfqzbjfch6pygv1td\",\n)\nprint(toll_free_campaign.id)"},{"lang":"Ruby","source":"require \"surge_api\"\n\nsurge = SurgeAPI::Client.new(api_key: \"My API Key\")\n\ntoll_free_campaign = surge.toll_free_campaigns.update(\"tfc_01j9a43avnfqzbjfch6pygv1td\")\n\nputs(toll_free_campaign)"}],"method":"patch","type":"path","servers":["5cd8d926-15b0-44c4-8dc1-0df43542d101"],"security":["53fb7dc9-e731-4f62-8da1-203cf7b549c7"],"path":"/toll_free_campaigns/{campaign_id}","baseUrlOptions":["https://api.surge.app"],"title":"Update a toll-free campaign","codeSamples":[{"lang":"JavaScript","source":"import Surge from '@surgeapi/node';\n\nconst client = new Surge({\n apiKey: process.env['SURGE_API_KEY'], // This is the default and can be omitted\n});\n\nconst tollFreeCampaign = await client.tollFreeCampaigns.update('tfc_01j9a43avnfqzbjfch6pygv1td');\n\nconsole.log(tollFreeCampaign.id);"},{"lang":"Python","source":"import os\nfrom surge import Surge\n\nclient = Surge(\n api_key=os.environ.get(\"SURGE_API_KEY\"), # This is the default and can be omitted\n)\ntoll_free_campaign = client.toll_free_campaigns.update(\n campaign_id=\"tfc_01j9a43avnfqzbjfch6pygv1td\",\n)\nprint(toll_free_campaign.id)"},{"lang":"Ruby","source":"require \"surge_api\"\n\nsurge = SurgeAPI::Client.new(api_key: \"My API Key\")\n\ntoll_free_campaign = surge.toll_free_campaigns.update(\"tfc_01j9a43avnfqzbjfch6pygv1td\")\n\nputs(toll_free_campaign)"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"b41ff09d-ff0d-4827-9c65-397e5a542d5f":{"in":"path","name":"campaign_id","required":true,"schema":{"description":"The toll-free campaign ID to update.","example":"tfc_01j9a43avnfqzbjfch6pygv1td","type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"title":"TollFreeCampaignUpdateParams","description":"Parameters for updating a toll-free campaign.","properties":{"consent_flows":{"items":{"oneOf":[{"type":"object","required":["type","script"],"properties":{"script":{"maxLength":2000,"minLength":20,"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.0.script","typeLabel":"string"},"type":{"enum":["verbal"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"consent_flows.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","owner"],"properties":{"owner":{"enum":["brand","platform"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.1.owner","typeLabel":"enum\u003cstring>"},"type":{"enum":["web_form"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"form_url":{"format":"uri","type":"string","uniqueKey":"consent_flows.items.[INDEX].oneOf.1.form_url","typeLabel":"string\u003curi>"},"screenshot":{"properties":{"reason":{"enum":["behind_login","under_construction","other"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.1.screenshot.reason","typeLabel":"enum\u003cstring>"},"urls":{"items":{"format":"uri","type":"string","uniqueKey":"consent_flows.items.[INDEX].oneOf.1.screenshot.urls.items.[INDEX]","typeLabel":"string\u003curi>"},"maxItems":5,"minItems":1,"type":"array","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.1.screenshot.urls","typeLabel":"string\u003curi>[]"},"reason_other":{"maxLength":500,"minLength":1,"type":"string","uniqueKey":"consent_flows.items.[INDEX].oneOf.1.screenshot.reason_other","typeLabel":"string"}},"required":["urls","reason"],"type":"object","uniqueKey":"consent_flows.items.[INDEX].oneOf.1.screenshot","typeLabel":"object"}},"uniqueKey":"consent_flows.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","file_urls"],"properties":{"file_urls":{"items":{"format":"uri","type":"string","uniqueKey":"consent_flows.items.[INDEX].oneOf.2.file_urls.items.[INDEX]","typeLabel":"string\u003curi>"},"maxItems":5,"minItems":1,"type":"array","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.2.file_urls","typeLabel":"string\u003curi>[]"},"type":{"enum":["text"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"keywords":{"items":{"maxLength":70,"pattern":"^[a-zA-Z0-9]+$","type":"string","uniqueKey":"consent_flows.items.[INDEX].oneOf.2.keywords.items.[INDEX]","typeLabel":"string"},"maxItems":1,"type":"array","uniqueKey":"consent_flows.items.[INDEX].oneOf.2.keywords","typeLabel":"string[]"}},"uniqueKey":"consent_flows.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","file_urls"],"properties":{"file_urls":{"items":{"format":"uri","type":"string","uniqueKey":"consent_flows.items.[INDEX].oneOf.3.file_urls.items.[INDEX]","typeLabel":"string\u003curi>"},"maxItems":5,"minItems":1,"type":"array","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.3.file_urls","typeLabel":"string\u003curi>[]"},"type":{"enum":["paper_form"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"consent_flows.items.[INDEX].oneOf.3","typeLabel":"object"}],"uniqueKey":"consent_flows.items.[INDEX]","typeLabel":"object"},"maxItems":1,"minItems":1,"type":"array","uniqueKey":"consent_flows","typeLabel":"object[]"},"description":{"description":"An explanation of how the toll-free number will be used.","maxLength":500,"minLength":40,"type":"string","uniqueKey":"description","typeLabel":"string"},"includes":{"items":{"enum":["age_gated"],"type":"string","uniqueKey":"includes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","uniqueItems":true,"uniqueKey":"includes","typeLabel":"enum\u003cstring>[]"},"message_samples":{"items":{"maxLength":1000,"type":"string","uniqueKey":"message_samples.items.[INDEX]","typeLabel":"string"},"maxItems":1,"minItems":1,"type":"array","uniqueKey":"message_samples","typeLabel":"string[]"},"privacy_policy_url":{"format":"uri","maxLength":255,"type":"string","uniqueKey":"privacy_policy_url","typeLabel":"string\u003curi>"},"terms_and_conditions_url":{"format":"uri","maxLength":255,"type":"string","uniqueKey":"terms_and_conditions_url","typeLabel":"string\u003curi>"},"use_cases":{"items":{"enum":["two_factor_authentication","account_notification","customer_care","charity","delivery_notification","fraud_alert","event","higher_education","k12_education","marketing","polling_voting","political","public_service_announcement","security_alert"],"type":"string","uniqueKey":"use_cases.items.[INDEX]","typeLabel":"enum\u003cstring>"},"minItems":1,"type":"array","uniqueKey":"use_cases","typeLabel":"enum\u003cstring>[]"}},"type":"object","uniqueKey":"","typeLabel":"TollFreeCampaignUpdateParams · object"},"examples":{"Example":{"title":"Example","value":{"consent_flows":[{"script":"\u003cstring>","type":"verbal"}],"description":"\u003cstring>","includes":["age_gated"],"message_samples":["\u003cstring>"],"privacy_policy_url":"\u003cstring>","terms_and_conditions_url":"\u003cstring>","use_cases":[]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"6b898b1f-d9e7-4446-923c-10fc0824954d":{"content":{"application/json":{"schema":{"title":"TollFreeCampaign","description":"A toll-free campaign registration for a phone number.","properties":{"consent_flows":{"items":{"oneOf":[{"type":"object","title":"TollFreeCampaignConsentFlow","description":"A consent flow returned on toll-free campaign responses.","required":["type","script"],"properties":{"script":{"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.0.script","typeLabel":"string"},"type":{"enum":["verbal"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"consent_flows.items.[INDEX].oneOf.0","typeLabel":"TollFreeCampaignConsentFlow · object"},{"type":"object","title":"TollFreeCampaignConsentFlow","description":"A consent flow returned on toll-free campaign responses.","required":["type","form_url"],"properties":{"form_url":{"format":"uri","type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.1.form_url","typeLabel":"string\u003curi>"},"type":{"enum":["web_form"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"consent_flows.items.[INDEX].oneOf.1","typeLabel":"TollFreeCampaignConsentFlow · object"},{"type":"object","title":"TollFreeCampaignConsentFlow","description":"A consent flow returned on toll-free campaign responses.","required":["type","screenshot"],"properties":{"screenshot":{"properties":{"reason":{"enum":["behind_login","under_construction","other"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.2.screenshot.reason","typeLabel":"enum\u003cstring>"},"reason_other":{"maxLength":500,"minLength":1,"type":"string","uniqueKey":"consent_flows.items.[INDEX].oneOf.2.screenshot.reason_other","typeLabel":"string"}},"required":["reason"],"type":"object","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.2.screenshot","typeLabel":"object"},"type":{"enum":["web_form"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"consent_flows.items.[INDEX].oneOf.2","typeLabel":"TollFreeCampaignConsentFlow · object"},{"type":"object","title":"TollFreeCampaignConsentFlow","description":"A consent flow returned on toll-free campaign responses.","required":["type"],"properties":{"type":{"enum":["text"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"keywords":{"items":{"maxLength":70,"pattern":"^[a-zA-Z0-9]+$","type":"string","uniqueKey":"consent_flows.items.[INDEX].oneOf.3.keywords.items.[INDEX]","typeLabel":"string"},"maxItems":1,"type":"array","uniqueKey":"consent_flows.items.[INDEX].oneOf.3.keywords","typeLabel":"string[]"}},"uniqueKey":"consent_flows.items.[INDEX].oneOf.3","typeLabel":"TollFreeCampaignConsentFlow · object"},{"type":"object","title":"TollFreeCampaignConsentFlow","description":"A consent flow returned on toll-free campaign responses.","required":["type"],"properties":{"type":{"enum":["paper_form"],"type":"string","isRequired":true,"uniqueKey":"consent_flows.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"consent_flows.items.[INDEX].oneOf.4","typeLabel":"TollFreeCampaignConsentFlow · object"}],"uniqueKey":"consent_flows.items.[INDEX]","typeLabel":"TollFreeCampaignConsentFlow · object"},"type":"array","isRequired":true,"uniqueKey":"consent_flows","typeLabel":"TollFreeCampaignConsentFlow · object[]"},"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"description","typeLabel":"string | null"},"id":{"description":"The toll-free campaign ID","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"includes":{"items":{"enum":["age_gated"],"type":"string","uniqueKey":"includes.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"includes","typeLabel":"enum\u003cstring>[]"},"message_samples":{"items":{"type":"string","uniqueKey":"message_samples.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"message_samples","typeLabel":"string[]"},"phone_number_id":{"description":"The toll-free phone number ID","type":"string","isRequired":true,"uniqueKey":"phone_number_id","typeLabel":"string"},"privacy_policy_url":{"oneOf":[{"format":"uri","type":"string","isRequired":true,"uniqueKey":"privacy_policy_url.oneOf.0","typeLabel":"string\u003curi>"},{"format":"uri","type":"null","isRequired":true,"uniqueKey":"privacy_policy_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"privacy_policy_url","typeLabel":"string\u003curi> | null"},"status":{"description":"The current status of the toll-free campaign.","enum":["active","canceled","created","in_review","rejected"],"type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"terms_and_conditions_url":{"oneOf":[{"format":"uri","type":"string","isRequired":true,"uniqueKey":"terms_and_conditions_url.oneOf.0","typeLabel":"string\u003curi>"},{"format":"uri","type":"null","isRequired":true,"uniqueKey":"terms_and_conditions_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"terms_and_conditions_url","typeLabel":"string\u003curi> | null"},"use_cases":{"items":{"enum":["two_factor_authentication","account_notification","customer_care","charity","delivery_notification","fraud_alert","event","higher_education","k12_education","marketing","polling_voting","political","public_service_announcement","security_alert"],"type":"string","uniqueKey":"use_cases.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"use_cases","typeLabel":"enum\u003cstring>[]"}},"required":["id","phone_number_id","status","use_cases","description","message_samples","includes","privacy_policy_url","terms_and_conditions_url","consent_flows"],"type":"object","uniqueKey":"","typeLabel":"TollFreeCampaign · object"},"examples":{"Example":{"title":"Example","value":{"consent_flows":[{"script":"\u003cstring>","type":"verbal"}],"description":"\u003cstring>","id":"\u003cstring>","includes":["age_gated"],"message_samples":["\u003cstring>"],"phone_number_id":"\u003cstring>","privacy_policy_url":"\u003cstring>","status":"active","terms_and_conditions_url":"\u003cstring>","use_cases":["two_factor_authentication"]}}},"exampleType":"generated"}},"description":"Updated toll-free campaign","exampleType":"generated"},"a4eef46e-90b9-4f69-9de2-c9d5b39bd46f":{"content":{"application/json":{"schema":{"title":"ErrorResponse","description":"An error response","example":{"error":{"message":"The requested resource could not be found.","type":"not_found"}},"properties":{"error":{"title":"Error","description":"An error response","example":{"message":"The requested resource was not found.","type":"not_found"},"properties":{"message":{"description":"A human-readable error message.","example":"The requested resource was not found.","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"description":"A unique error code.","example":"not_found","type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"detail":{"additionalProperties":true,"description":"Additional details about the error.","type":"object","uniqueKey":"error.detail","typeLabel":"object"}},"required":["type","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"The requested resource could not be found.","type":"not_found"}}}},"exampleType":"generated"}},"description":"Campaign is not in an updatable status","exampleType":"generated"},"cd048b66-f13a-4e60-81c5-50835d2268dd":{"content":{"application/json":{"schema":{"title":"ErrorResponse","description":"An error response","example":{"error":{"message":"The requested resource could not be found.","type":"not_found"}},"properties":{"error":{"title":"Error","description":"An error response","example":{"message":"The requested resource was not found.","type":"not_found"},"properties":{"message":{"description":"A human-readable error message.","example":"The requested resource was not found.","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"description":"A unique error code.","example":"not_found","type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"detail":{"additionalProperties":true,"description":"Additional details about the error.","type":"object","uniqueKey":"error.detail","typeLabel":"object"}},"required":["type","message"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"Error · object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"The requested resource could not be found.","type":"not_found"}}}},"exampleType":"generated"}},"description":"Error","exampleType":"generated"}},"security":{"53fb7dc9-e731-4f62-8da1-203cf7b549c7":{"authorization":{"bearerFormat":"Surge API token","scheme":"bearer","type":"http","scopes":[],"schemeName":"authorization"}}},"servers":{"5cd8d926-15b0-44c4-8dc1-0df43542d101":{"url":"https://api.surge.app"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"Surge API token","scheme":"bearer","type":"http","scopes":[],"schemeName":"authorization"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"authorization","name":"Authorization"}],"title":"authorization"}]},"originalFileLocation":"openapi.documented.json"},"subdomain":"surge-67d47b03","siteName":"Surge","title":"Update toll-free campaign - Surge","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T18:05:45.783Z","originalFileLocation":"api-reference/endpoint/toll-free-campaigns/update.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Surge\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update toll-free campaign - Surge\">\u003cmeta data-mint-head property=\"og:description\" content=\"Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Surge\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://surgemsg.com/images/surge-preview-9b01c93f5b24bb5128b47c354c371546.jpg?vsn=d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update toll-free campaign - Surge\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://surgemsg.com/images/surge-preview-9b01c93f5b24bb5128b47c354c371546.jpg?vsn=d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/surge-67d47b03/sXzShSiekorghOlZ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Surge\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8200ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/toll-free-campaigns/update.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.surge.app/#organization\",\"name\":\"Surge\",\"url\":\"https://docs.surge.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/surge-67d47b03/1YdD2Aq20HHnJtCK/logo.svg?fit=max\u0026auto=format\u0026n=1YdD2Aq20HHnJtCK\u0026q=85\u0026s=fb53e91d462980a01e9b7c046c98f339\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.surge.app#website\",\"name\":\"Surge\",\"url\":\"https://docs.surge.app\",\"publisher\":{\"@id\":\"https://docs.surge.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update#webpage\",\"url\":\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update\",\"name\":\"Update toll-free campaign\",\"description\":\"Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.\",\"dateModified\":\"2026-11-04T18:05:45.783Z\",\"isPartOf\":{\"@id\":\"https://docs.surge.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.surge.app/api-reference/endpoint/accounts/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Toll-free Campaigns\",\"item\":\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/create\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update toll-free campaign\",\"item\":\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update#apireference\",\"headline\":\"Update toll-free campaign\",\"name\":\"Update toll-free campaign\",\"description\":\"Update a toll-free campaign that needs customer fixes and resubmit it for Surge review. Returns 409 if the campaign cannot be updated.\",\"url\":\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.surge.app/api-reference/endpoint/toll-free-campaigns/update#webpage\"},\"image\":\"https://surgemsg.com/images/surge-preview-9b01c93f5b24bb5128b47c354c371546.jpg?vsn=d\",\"dateModified\":\"2026-11-04T18:05:45.783Z\",\"publisher\":{\"@id\":\"https://docs.surge.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.surge.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Surge\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Surge","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/overview/what-is-surge"}]},{"anchor":"SDKs","icon":"code","pages":[{"title":"SDKs","href":"/sdks"}]},{"anchor":"API Reference","icon":"terminal","groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Error Reference","href":"/api-reference/errors"}]},{"group":"Endpoints","pages":[{"group":"Accounts","pages":[{"title":"Create account","openapi":"POST /accounts","href":"/api-reference/endpoint/accounts/create"},{"title":"List accounts","openapi":"GET /accounts","href":"/api-reference/endpoint/accounts/list"},{"title":"Retrieve account","openapi":"GET /accounts/{id}","href":"/api-reference/endpoint/accounts/get"},{"title":"Check account status","openapi":"GET /accounts/{account_id}/status","href":"/api-reference/endpoint/accounts/check-status"},{"title":"Update account","openapi":"PATCH /accounts/{id}","href":"/api-reference/endpoint/accounts/update"},{"title":"Archive account","openapi":"DELETE /accounts/{id}","href":"/api-reference/endpoint/accounts/archive"}]},{"group":"Attachments","pages":[{"title":"Retrieve attachment file","openapi":"GET /attachments/{attachment_id}/file","href":"/api-reference/endpoint/attachments/get-file"}]},{"group":"Audiences","pages":[{"title":"Create audience","openapi":"POST /accounts/{account_id}/audiences","href":"/api-reference/endpoint/audiences/create"},{"title":"Add contact to audience","openapi":"POST /audiences/{audience_id}/contacts","href":"/api-reference/endpoint/audiences/add-contact"},{"title":"List audience contacts","openapi":"GET /audiences/{audience_id}/contacts","href":"/api-reference/endpoint/audiences/list-contacts"}]},{"group":"Blasts","pages":[{"title":"Create blast","openapi":"POST /accounts/{account_id}/blasts","href":"/api-reference/endpoint/blasts/create"}]},{"group":"Campaigns","pages":[{"title":"Create campaign","openapi":"POST /accounts/{account_id}/campaigns","href":"/api-reference/endpoint/campaigns/create"},{"title":"List campaigns","openapi":"GET /accounts/{account_id}/campaigns","href":"/api-reference/endpoint/campaigns/list"},{"title":"Retrieve campaign","openapi":"GET /campaigns/{id}","href":"/api-reference/endpoint/campaigns/get"},{"title":"Update campaign","openapi":"PATCH /campaigns/{id}","href":"/api-reference/endpoint/campaigns/update"},{"title":"Resend brand verification OTP","openapi":"POST /accounts/{account_id}/brand_verification_messages","href":"/api-reference/endpoint/campaigns/resend-brand-verification-message"}]},{"group":"Contacts","pages":[{"title":"Create contact","openapi":"POST /accounts/{account_id}/contacts","href":"/api-reference/endpoint/contacts/create"},{"title":"List contacts","openapi":"GET /accounts/{account_id}/contacts","href":"/api-reference/endpoint/contacts/list"},{"title":"Retrieve contact","openapi":"GET /contacts/{id}","href":"/api-reference/endpoint/contacts/get"},{"title":"Update contact","openapi":"PATCH /contacts/{id}","href":"/api-reference/endpoint/contacts/update"}]},{"group":"Messages","pages":[{"title":"Send message","openapi":"POST /accounts/{account_id}/messages","href":"/api-reference/endpoint/messages/create"},{"title":"List messages","openapi":"GET /accounts/{account_id}/messages","href":"/api-reference/endpoint/messages/list"},{"title":"Retrieve message","openapi":"GET /messages/{id}","href":"/api-reference/endpoint/messages/get"}]},{"group":"Phone numbers","pages":[{"title":"Purchase phone number","openapi":"POST /accounts/{account_id}/phone_numbers","href":"/api-reference/endpoint/phone-numbers/purchase"},{"title":"List phone numbers","openapi":"GET /accounts/{account_id}/phone_numbers","href":"/api-reference/endpoint/phone-numbers/list"},{"title":"Retrieve phone number","openapi":"GET /phone_numbers/{id}","href":"/api-reference/endpoint/phone-numbers/get"},{"title":"Update phone number","openapi":"PATCH /phone_numbers/{id}","href":"/api-reference/endpoint/phone-numbers/update"},{"title":"Release phone number","openapi":"DELETE /phone_numbers/{id}","href":"/api-reference/endpoint/phone-numbers/release"},{"title":"List available numbers","openapi":"GET /accounts/{account_id}/available_phone_numbers","href":"/api-reference/endpoint/phone-numbers/list-available-numbers"}]},{"group":"Recordings","pages":[{"title":"List recordings","openapi":"GET /accounts/{account_id}/recordings","href":"/api-reference/endpoint/recordings/list"},{"title":"Retrieve recording","openapi":"GET /recordings/{id}","href":"/api-reference/endpoint/recordings/get"},{"title":"Delete recording","openapi":"DELETE /recordings/{id}","href":"/api-reference/endpoint/recordings/delete"},{"title":"Download recording file","openapi":"GET /recordings/{recording_id}/file","href":"/api-reference/endpoint/recordings/get-file"}]},{"group":"Toll-free Campaigns","pages":[{"title":"Create toll-free campaign","openapi":"POST /accounts/{account_id}/toll_free_campaigns","href":"/api-reference/endpoint/toll-free-campaigns/create"},{"title":"List toll-free campaigns","openapi":"GET /accounts/{account_id}/toll_free_campaigns","href":"/api-reference/endpoint/toll-free-campaigns/list"},{"title":"Retrieve toll-free campaign","description":"Retrieve a toll-free campaign by ID.","openapi":"GET /toll_free_campaigns/{campaign_id}","href":"/api-reference/endpoint/toll-free-campaigns/get"},{"title":"Update toll-free campaign","openapi":"PATCH /toll_free_campaigns/{campaign_id}","href":"/api-reference/endpoint/toll-free-campaigns/update"}]},{"group":"Users","pages":[{"title":"Create user","description":"Create a user record under an account. Users are shown inside embeddable UI components.","openapi":"POST /accounts/{account_id}/users","href":"/api-reference/endpoint/users/create"},{"title":"List users","openapi":"GET /accounts/{account_id}/users","href":"/api-reference/endpoint/users/list"},{"title":"Retrieve user","openapi":"GET /users/{id}","href":"/api-reference/endpoint/users/get"},{"title":"Update user","openapi":"PATCH /users/{id}","href":"/api-reference/endpoint/users/update"},{"title":"Delete user","openapi":"DELETE /users/{id}","href":"/api-reference/endpoint/users/delete"},{"title":"Create user token","openapi":"POST /users/{user_id}/tokens","href":"/api-reference/endpoint/users/create-token"}]},{"group":"Verifications","pages":[{"title":"Create verification","openapi":"POST /accounts/{account_id}/verifications","href":"/api-reference/endpoint/verifications/create"},{"title":"Check verification","openapi":"POST /verifications/{id}/checks","href":"/api-reference/endpoint/verifications/check"}]}]},{"group":"Webhooks","pages":[{"title":"Webhooks Overview","href":"/api-reference/webhooks/intro"},{"title":"Signature Verification","href":"/api-reference/webhooks/signature-validation"},{"group":"Events","pages":[{"title":"message.sent","openapi":"webhook messageSent","href":"/api-reference/webhooks/message/sent"},{"title":"message.delivered","openapi":"webhook messageDelivered","href":"/api-reference/webhooks/message/delivered"},{"title":"message.failed","openapi":"webhook messageFailed","href":"/api-reference/webhooks/message/failed"},{"title":"message.received","openapi":"webhook messageReceived","href":"/api-reference/webhooks/message/received"},{"title":"contact.opted_in","openapi":"webhook contactOptedIn","href":"/api-reference/webhooks/contact/opted_in"},{"title":"contact.opted_out","openapi":"webhook contactOptedOut","href":"/api-reference/webhooks/contact/opted_out"},{"title":"conversation.created","openapi":"webhook conversationCreated","href":"/api-reference/webhooks/conversation/created"},{"title":"campaign.approved","openapi":"webhook campaignApproved","href":"/api-reference/webhooks/campaign/approved"},{"title":"phone_number.imported","openapi":"webhook phoneNumberImported","href":"/api-reference/webhooks/phone_number/imported"},{"title":"phone_number.attached_to_campaign","openapi":"webhook phoneNumberAttachedToCampaign","href":"/api-reference/webhooks/phone_number/attached_to_campaign"},{"title":"link.followed","openapi":"webhook linkFollowed","href":"/api-reference/webhooks/link/followed"},{"title":"call.ended","openapi":"webhook callEnded","href":"/api-reference/webhooks/call/ended"},{"title":"recording.completed","openapi":"webhook recordingCompleted","href":"/api-reference/webhooks/recording/completed"},{"title":"voicemail.received","openapi":"webhook voicemailReceived","href":"/api-reference/webhooks/voicemail/received"}]}]}]},{"anchor":"Resources","icon":"folder-open","pages":[{"title":"Resources","href":"/resources/hipaa"}]}]},"basePath":"","title":"Update toll-free campaign - Surge","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}