Build customer support into anything

Connect your systems to Sonny with a clear, versioned API for contacts, conversations, internal notes, and webhooks.

Your first request

cURL

curl https://www.usesonny.com/api/v1/contacts \
  --header "Authorization: Bearer sonny_your_key"

The interactive reference includes request schemas, example responses, required scopes, and a built-in request client.

A practical surface

The product workflows you actually need

Automate routine work without rebuilding Sonny's inbox rules, permissions, or delivery behavior in your integration.

Useful resources: Work with contacts, conversations, message history, and internal notes through a stable JSON contract.
Events when they happen: Create signed webhook endpoints, choose events, inspect deliveries, and retry failures.
Behavior you can rely on: API calls use the same permissions, validation, and workflows as the Sonny app, so behavior stays consistent.

Security

Create a key for one job, give it only the scopes it needs, and keep the secret in your server-side environment.

Scoped keys: Choose read or write access per resource. Keys belong to one workspace, expire automatically, and can be revoked immediately.
One workspace per key: Every request re-checks the key owner, workspace membership, role, billing state, and resource scope before touching data.

Create a scoped key, copy the example, and inspect every operation in the interactive reference.