Build customer support into anything

Connect your systems to Sonny with a clear, versioned API for inbox triage, customer context, reports, and replies with files.

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.

Act on the right conversations: Find unanswered conversations, assign available teammates, update work in batches, and send replies with files.
Keep your agent in sync: Catch up through a durable change feed with replay and deletion records. Use signed webhooks to wake your integration.
Context and reports in one place: Share customer memories and typed properties with Sonny AI, and read the same support reports your team uses.

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.