Send SMS
seven.send_sms
ActionVoice & SMSconnection required
Calls the seven.io API with the connection's credentials.
Send a text message to one or more numbers through the seven.io gateway.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- seven.io
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- sender, account_id, base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
9 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
to Recipient number in international format; separate several with commas. | string | Yes | — | — | +4917612345678 |
text The message body to send. | string | Yes | — | — | Your order has shipped. |
sender Sender ID for this message; overrides the connection's default sender. | string | No | — | ≤ 16 characters | AcmeInc |
label Label to file this message under in seven.io's statistics. | string | No | — | — | — |
foreign_id Your own identifier for this message, echoed back on status reports. | string | No | — | — | — |
delay Send at this time instead of now, as a Unix timestamp or 'YYYY-MM-DD hh:mm:ss'. | string | No | — | — | 2026-01-01 09:00:00 |
ttl How many minutes the gateway keeps retrying before giving up; seven.io defaults to 2880. | number | No | — | ≥ 1 | — |
flash Send as a flash SMS, which appears on the handset without being stored. | boolean | No | — | — | — |
performance_tracking Shorten links in the message so seven.io can count the clicks. | boolean | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"delay": "2026-01-01 09:00:00",
"sender": "AcmeInc",
"text": "Your order has shipped.",
"to": "+4917612345678"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
code seven.io's return code; '100' means the gateway accepted it. | string | — |
accepted How many recipients the gateway accepted. | number | — |
requested How many recipients were in the request. | number | — |
ids The gateway's message id for each accepted recipient. | array | — |
messages One row per recipient, as seven.io returned it. | array | — |
total_price What the whole request cost, in the account's currency. | number | — |
balance The account balance left after the send. | number | — |
sms_type How the gateway routed the message, empty for voice. | string | — |
{
"accepted": 0,
"balance": 0,
"code": "",
"ids": [],
"messages": [],
"requested": 0,
"sms_type": "",
"total_price": 0
}See Send SMS run in a workflow.
In a technical demo we add the seven.io connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.