API Reference
Endpoint reference for the Samva email API, generated from the OpenAPI specification.
The Samva API is a REST API: requests and responses are JSON, and standard HTTP status codes signal success or failure. Browse endpoints by service in the sidebar, or start from the conventions reference below.
Channel availability
| Channel | Status | Notes |
|---|---|---|
| ✅ Live | Full send, domains, threading, analytics | |
| SMS | 🔜 Staged | Coming soon |
| 🔜 Staged | Coming soon | |
| Voice | 🔜 Staged | Coming soon |
Email first. Samva is launching with email. SMS, WhatsApp, and voice are staged and will be documented as they ship.
OpenAPI specification: the live spec is published at api.samva.app/v1/openapi.json. See the OpenAPI page for details.
Conventions
Shared conventions — base URL, authentication, request and response shapes, status codes, errors, and pagination — are documented once in the REST API reference. Start there, then use the per-endpoint pages in the sidebar.
REST conventions
Base URL, headers, status codes, errors, and pagination.
Authentication
API keys, headers, and error responses.
TypeScript SDK
The official SDK over this API.
Send an email
A runnable send walkthrough in curl, Python, Go, and PHP.
Endpoints by service
- Messages — send and manage email messages
- Email — domains, senders, threading, and management
- Conversations — conversation threading
- Contacts — contact management
- Webhooks — webhook endpoint configuration
- API Keys — API key management
- Organizations — organization settings
Support
Need help with the API? Email support@samva.app.