Surge home page

Support Dashboard

Documentation SDKs API Reference Resources

API ReferenceSwitch docs section

DocumentationConcepts, walkthroughs, embeddable UI, and operational setup.SDKsPython, TypeScript, Ruby, and Elixir client libraries.API ReferenceAuth, endpoints, example payloads, and webhook event schemas.ResourcesCompliance, changelog, deprecations, and glossary.

API Reference Introduction Authentication Error Reference

Endpoints

Accounts

Create account Check account status Update account Archive account List accounts

Audiences

Create audience Add contact to audience List audience contacts

Blasts

Campaigns

Create campaign List campaigns Get campaign Update campaign

Contacts

List contacts Create contact Get contact Update contact

Messages

List messages Send message Get message

Phone Numbers

List phone numbers Purchase phone number

Recordings

List recordings Get recording Delete recording Download recording file

Users

Create user List users Get user Update user Delete user Create user token

Verifications

Create verification Check verification

Attachments

Get attachment file Get attachment

Webhooks

Webhooks Overview Signature Verification

Message

message.sent message.delivered message.failed message.received

Contact

contact.opted_in contact.opted_out

Conversation

conversation.created

Campaign

campaign.approved

Phone Number

phone_number.attached_to_campaign

Link

Call

Recording

recording.completed

Voicemail

voicemail.received

Campaigns

Create campaign

Register a new A2P 10DLC campaign with The Campaign Registry under an account.

Get campaign

Retrieve a single campaign by ID, including its current registration status.

List campaigns

List all campaigns registered to an account with cursor-based pagination.

Update campaign

Update campaign details to address changes-needed feedback from carrier review.

Endpoint/Campaigns

Campaigns

Create campaign

Register a new A2P 10DLC campaign with The Campaign Registry under an account.

Get campaign

Retrieve a single campaign by ID, including its current registration status.

List campaigns

List all campaigns registered to an account with cursor-based pagination.

Update campaign

Update campaign details to address changes-needed feedback from carrier review.

llms.txt llms-full.txtLast updated May 13, 2026

On this page

No Headings