REST API logo

Developers

The Signilio SMS API: send, receive and track business texts from your code

Use the Signilio REST API to send business texts, run campaigns, sync opt-outs and read replies from your own software. Scoped keys and signed webhooks.

The Signilio SMS API is a REST API for business texting: send a text with one POST request, read the replies, run campaigns, and keep opt-outs in sync, all from your own software. Every request uses a scoped API key, every text goes out from your Signilio numbers, and the same opt-out and blacklist checks apply as in the Signilio app. Replies and events reach your system through signed webhooks.

What you can do with it

  • Messaging: send a text, list messages and get one message's details.
  • Conversations: list and read threads, and flag, assign, hand off, archive or unarchive them.
  • Contacts and opt-outs: look up a contact by phone, opt them out, re-subscribe them for one rep, or add them to the blacklist.
  • Campaigns: create, start, pause and resume campaigns, and read their results.
  • Lists, reps, numbers and account: read your lists, team, numbers, balance and limits.
  • Events: subscribe to replies, deliveries, failures and opt-outs.

Built for production

  • Scoped keys. Each key gets only the permissions you choose, an optional expiry, and can be revoked at any time.
  • Safe retries. Send an Idempotency-Key with each text and a retried request never sends twice.
  • Signed events. Every webhook carries an HMAC-SHA256 signature you verify before trusting it.

The full developer guide is shared with customers on request. Contact us for access.

What the Signilio API covers

Send and read texts

POST /send sends a text from your numbers. GET /messages and GET /messages/{id} read what was sent and received.

Work the conversation

List conversations, read one, and flag, assign, hand off, archive or unarchive it.

Opt-outs your way

Opt a contact out, re-subscribe them for one rep, or blacklist a number, so your system and Signilio stay in step.

Campaigns from code

Create campaigns, then start, pause or resume them and read their results.

Account at a glance

Read your reps, numbers, balance and sending limits before you send.

Real-time events

Subscribe to replies, deliveries, failures and opt-outs with signed webhooks.

How to start with the Signilio API

  1. 1

    Create an API key

    The account owner opens Settings → Integrations → API keys, clicks + Create API Key, names it and chooses its permissions and optional expiry. Tick Allow starting brand-new conversations if the key should text numbers you haven't texted before.

  2. 2

    Store the key safely

    The full key is shown once. Keep it in your server's secret store, never in a browser or app.

  3. 3

    Send your first text

    POST to /v1/send with the to number and message body, using the key as a bearer token. Without Allow starting brand-new conversations, a key can only reply to existing conversations.

  4. 4

    Receive replies

    Set a webhook URL and subscribe to message.received, then verify each delivery's signature.

Example

Send a text
curl -X POST https://api.signilio.com/v1/send \
  -H "Authorization: Bearer $SIGNILIO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 4e1c8f90-2a7b-4c3e-9f1a-7d2b6c5e0a13" \
  -d '{ "to": "+13105551234", "body": "Hi Dana, following up on your request." }'
Response
{ "message_id": "…", "status": "sent", "sent_via_api": true }

Good to know

  • The API doesn't move money, buy numbers, register brands or campaigns, manage users or create API keys. Those stay in the Signilio app.
  • A number added to the blacklist can't be removed through the API.
  • By default, a new key only replies to existing conversations. To text new numbers, create the key with Allow starting brand-new conversations ticked.
  • Texts sent through the API count toward your Signilio plan like any other text.

SMS API questions

What is an SMS API?
An SMS API lets your own software send and receive text messages by making web requests, instead of a person sending them in an app. With Signilio, one POST request sends a text from your business numbers.
Is the Signilio API two-way?
Yes. You send texts with POST /send and receive replies through the message.received webhook, or by reading conversations.
How do I authenticate?
Send your API key as a bearer token in the Authorization header. Each key has only the permissions you gave it.
Does the API respect opt-outs?
Yes. Every text sent through the API passes the same opt-out and blacklist checks as a text sent from the app.
How do I avoid sending a text twice when I retry?
Include an Idempotency-Key header on each send. Retrying with the same key returns the original result instead of sending again.
What are the rate limits?
600 requests a minute per API key. Your account's daily sending limit applies separately.
Where is the API documentation?
The developer guide is shared with customers on request. Contact us and we'll send it.

All integrations →