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

Webhooks

Call

Call

Campaign

Contact

Conversation

Conversation

Link

Link

Message

Phone Number

Phone Number

Recording

Signature Verification

Verify Surge webhook signatures using Standard Webhooks HMAC-SHA256 to authenticate incoming requests.

Voicemail

Webhooks Overview

How Surge webhook delivery works: event types, retry behaviour, and where to configure your endpoint.

Webhooks

Call

Call

Campaign

Contact

Conversation

Conversation

Link

Link

Message

Phone Number

Phone Number

Recording

Signature Verification

Verify Surge webhook signatures using Standard Webhooks HMAC-SHA256 to authenticate incoming requests.

Voicemail

Webhooks Overview

How Surge webhook delivery works: event types, retry behaviour, and where to configure your endpoint.

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

On this page

No Headings