REST API — programmatic access to your data
Read and write contacts, deals, tasks, activities, pipelines from your code.
Spec + base URL
Full OpenAPI 3.0 spec at sambandh.io/openapi.json. Base URL: https://sambandh.io/api/v1. All endpoints require Bearer-token authentication.
Generating an API key
Create a new key
Click + New key. Name it for the use case ("Zapier", "internal-script", etc). Pick scopes: read, write, or admin. The key is shown ONCE — copy it now or rotate later.
Test from your terminal
curl -H "Authorization: Bearer sb_live_yourkey" https://sambandh.io/api/v1/contacts?limit=5 should return 5 contacts.
Common operations
- List contacts: GET /api/v1/contacts (filterable + cursor-paginated)
- Create contact: POST /api/v1/contacts
- Update contact: PATCH /api/v1/contacts/:id
- List deals: GET /api/v1/deals (filter by pipelineId, stage)
- Create / update deal: POST / PATCH /api/v1/deals
- Create task: POST /api/v1/tasks
- Log activity: POST /api/v1/activities
Rate limits
Per-org per-minute limits documented at /developers and the OpenAPI spec. Responses include X-RateLimit-Limit / -Remaining / -Reset headers; 429 responses include Retry-After.
Up next
Saw something off? Email support with what doesn't match — these docs are versioned with the product, so any drift is a bug we want to fix.
Deployment dpl_3s4XtSevgjgpHE7ieimBFL8cv8uY
These docs are versioned with the product. If something doesn't match what you see in the app, the app is right — please flag it to support@sambandh.io.