List inbound messages

List SMS received on your workspace's virtual number - recipient replies, keyword responses ("reply 8 to…"), and opt-out requests. Ordered oldest first with cursor pagination. Read-only: this is the polling surface for Make, n8n, Zapier and your own automations. Returns an empty list when the workspace has no virtual number.

Polling for new messages. Pass ?since= (ISO 8601) to bound the list to a recent window - e.g. poll every few minutes with since set to the last day and de-duplicate by id on your side. since filters on received_at, inclusive. For a full export, page with cursor instead.

curl "https://sendy.co.il/api/v1/inbound?since=2026-08-24T00:00:00Z&limit=50" \
  -H "Authorization: Bearer sk_live_8Jc…"

const params = new URLSearchParams({ since: "2026-08-24T00:00:00Z", limit: "50" });
const res = await fetch(`https://sendy.co.il/api/v1/inbound?${params}`, {
  headers: { Authorization: "Bearer sk_live_8Jc…" },
});
const { data, has_more, next_cursor } = await res.json();

{
  "data": [
    {
      "id": "cmc0inbound0001",
      "from": "+972501234567",
      "to": "+972531234567",
      "text": "אשמח לקבל פרטים נוספים",
      "opt_out": "none",
      "opt_out_applied_at": null,
      "received_at": "2026-08-24T10:15:00.000Z"
    },
    {
      "id": "cmc0inbound0002",
      "from": "+972529876543",
      "to": "+972531234567",
      "text": "הסר",
      "opt_out": "detected",
      "opt_out_applied_at": "2026-08-24T10:16:02.312Z",
      "received_at": "2026-08-24T10:16:01.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

from is E.164 when the sender is an Israeli mobile - the same format as a contact's phone, so you can look the sender up with GET /contacts?phone=. It can also be an alphanumeric or foreign sender, passed through verbatim. opt_out is "detected" (the message is an opt-out request - Sendy unsubscribes the sender automatically; opt_out_applied_at records when), "suspected" (a removal word inside a longer message, flagged for review in the app, never auto-applied) or "none". Long inbound messages can arrive as multiple rows (one per SMS part).