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
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
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
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
Receive replies
Set a webhook URL and subscribe to message.received, then verify each delivery's signature.
Example
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." }'{ "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.