API overview

The Messages API is a versioned HTTP API for sending and receiving traffic on your Comms line.

Base URL

https://osis.co

All routes in this reference live under:

/api/v1/comms

Authorization: Bearer <COMMS_API_KEY>

Keys are minted in the dashboard: Messages API. See Authentication for scopes, rotation, and security rules.

Topic	Rule
Content type	`application/json` on bodies
Phone numbers	E.164 (`+12125550147`)
Idempotency	Header `Idempotency-Key` on outbound sends
Errors	`{ "error": "…" }` JSON
Time	ISO-8601 where timestamps appear

Method	Path	Scope	Docs
`POST`	`/api/v1/comms/messages`	`comms_send`	Send
`GET`	`/api/v1/comms/messages`	`comms_read`	List

Method	Path	Scope	Docs
`GET`	`/api/v1/comms/conversations`	`comms_read`	List

Method	Path	Scope	Docs
`GET`	`/api/v1/comms/contacts`	`comms_read`	List
`POST`	`/api/v1/comms/contacts`	`write`*	Upsert

*Contact upsert currently expects the broader write scope when present on the key.

Method	Path	Scope	Docs
`GET`	`/api/v1/comms/webhooks`	`comms_webhooks`	List
`POST`	`/api/v1/comms/webhooks`	`comms_webhooks`	Create

Method	Path	Scope	Docs
`GET`	`/api/v1/comms/events`	`comms_read`	List

See Errors & rate limits. Defaults are roughly 100 requests/min globally and 60 sends/min per caller.

There is no required SDK. Use any HTTP client with a Bearer token. The quickstart shows cURL, Node, and Python.