ONE sms:send
← Receivers

sms:send

sms family

mcp

Send one text message from the workspace's own Twilio number, through Composio, behind the consent gate. `purpose` decides the bar: conversational (a reply to someone who texted in) and invite (a fixed 'reply YES for offers' ask, never free text) only from the channels text door's own signed send — anyone else is sent as marketing — or marketing (needs their JOIN, or YES to an invitation). STOP, a suppression or Twilio's 21610 refuses all. Capped per number per day (marketing 1, invitations 1, replies 25) and metered against the workspace's daily Composio calls. No Twilio account connected answers sms_not_configured with cannot_run, never sent.

Effect
ask
Awaits an outcome — the call returns the response below.
Caller
write
The class of authority the caller must already hold, decided from the attested context with no round trip.
Cost
variable
What one call costs, so you can budget before acting.
Reversible
no
This cannot be undone. Dry-run it first where the contract allows.
Idempotent
no
Not safe to blind-retry — dedupe on the envelope idempotencyKey.
Version
1.0.0
Pin this to keep a contract stable; additive bumps never break callers.

Send it with your agent

One click hands your coding agent a prompt that registers the substrate, reads this contract, and makes the call. Launch opens the app; the others copy the prompt.

Claude Code
Codex
Cursor
Gemini CLI
Claude Desktop
ChatGPT
curl -X POST https://one.ie/api/ask/sms:send \
  -H "Authorization: Bearer $ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": { "to": "+15551234567", "body": "Thanks! What postcode are you in?", "purpose": "conversational" }}'

The key is never in a link. npx -y @oneie/cli login writes it to ~/.config/oneie/key on your machine.

Request

Validated before dispatch — an invalid payload is refused with the fix, never half-applied.

  • to string required The person's number with its country code, e.g. +15551234567; punctuation is ignored
  • body string required The text, 1-1600 characters
  • purpose conversational | marketing | invite required conversational: the desk answering, qualifying, booking or confirming a conversation the person started by texting in — only the channels text door may say this; any other caller's text is sent as marketing. invite: one 'reply YES to get offers' ask to someone who texted in; their YES then opts them in. marketing: a campaign, sequence or promo, which needs the person's express opt-in (JOIN, or YES to an invitation). Required: a text that does not say why is not sent
  • workspace string optional The workspace to send from; defaults to the caller's own. Naming another needs control of it
  • slug string optional Service callers only (the channels door): the workspace the reply belongs to
  • campaign string optional Campaign id stamped on the sms-sent event
  • attest string optional The channels text door's HMAC over (workspace, to, body, purpose, at). Only a send carrying it, fresh, may be conversational or an invite; without it the send is marketing
  • at number optional Epoch ms the door signed at; older than five minutes is not the door

Response

What comes back from the call.

  • ok boolean
  • purpose string
  • from string The workspace's number it went from
  • to string The number in E.164
  • sid string Twilio's message sid
  • error string forbidden · bad_request · bad_number · consent_declined · consent_unreadable · no_sms_consent · no_marketing_consent · marketing_cap · invite_cap · reply_cap · capped · over_limit · sms_not_configured · sms_provider_unreachable · sms_send_failed
  • cannot_run boolean true when the environment, not the build, stopped it: no Twilio number or account, or Composio unreachable
  • detail string

Traffic

Every call to sms:send, counted where it is dispatched — over HTTP or in-process alike. Aggregate only — no actor, no payload, no workspace.

Counting…

Wiring

Every place in the open source that names sms:send, and the file that answers it. Read from the tree at build time — a receiver is reached by NAME through one door, so there is no import edge to follow and a grep is the honest shape of the question. Structure, not volume — the count is in Traffic above.

Called from

API route 4
  • one.ie/web/src/lib/receiver-index.generated.ts:373
  • one.ie/web/src/lib/resolvers/sms.ts:68
  • one.ie/web/src/lib/sms/sms.ts:3
  • one.ie/web/src/lib/sms/twilio.ts:4
Agent runtime 2
  • channels/src/agents/campaign-sms.ts:9
  • channels/src/channels/sms.ts:18
CLI 1
  • packages/cli/src/sms.ts:23
→

Answered by

sms:send one.ie/web/src/lib/resolvers/sms.ts:61 Dispatched through POST /api/ask/sms:send, after the envelope validates the payload.

sms family · 1 more

JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "description": "The person's number with its country code, e.g. +15551234567; punctuation is ignored"
    },
    "body": {
      "type": "string",
      "description": "The text, 1-1600 characters"
    },
    "purpose": {
      "type": "string",
      "enum": [
        "conversational",
        "marketing",
        "invite"
      ],
      "description": "conversational: the desk answering, qualifying, booking or confirming a conversation the person started by texting in — only the channels text door may say this; any other caller's text is sent as marketing. invite: one 'reply YES to get offers' ask to someone who texted in; their YES then opts them in. marketing: a campaign, sequence or promo, which needs the person's express opt-in (JOIN, or YES to an invitation). Required: a text that does not say why is not sent"
    },
    "workspace": {
      "description": "The workspace to send from; defaults to the caller's own. Naming another needs control of it",
      "type": "string"
    },
    "slug": {
      "description": "Service callers only (the channels door): the workspace the reply belongs to",
      "type": "string"
    },
    "campaign": {
      "description": "Campaign id stamped on the sms-sent event",
      "type": "string"
    },
    "attest": {
      "description": "The channels text door's HMAC over (workspace, to, body, purpose, at). Only a send carrying it, fresh, may be conversational or an invite; without it the send is marketing",
      "type": "string"
    },
    "at": {
      "description": "Epoch ms the door signed at; older than five minutes is not the door",
      "type": "number"
    }
  },
  "required": [
    "to",
    "body",
    "purpose"
  ]
}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "purpose": {
      "type": "string"
    },
    "from": {
      "description": "The workspace's number it went from",
      "type": "string"
    },
    "to": {
      "description": "The number in E.164",
      "type": "string"
    },
    "sid": {
      "description": "Twilio's message sid",
      "type": "string"
    },
    "error": {
      "description": "forbidden · bad_request · bad_number · consent_declined · consent_unreadable · no_sms_consent · no_marketing_consent · marketing_cap · invite_cap · reply_cap · capped · over_limit · sms_not_configured · sms_provider_unreachable · sms_send_failed",
      "type": "string"
    },
    "cannot_run": {
      "description": "true when the environment, not the build, stopped it: no Twilio number or account, or Composio unreachable",
      "type": "boolean"
    },
    "detail": {
      "type": "string"
    }
  },
  "required": [
    "ok"
  ]
}