Send SMS - Naïve

POST

phone

:id

sms

curl -X POST https://api.usenaive.ai/v1/phone/phone-uuid/sms \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "to": "+14155551234", "body": "Your order shipped!" }'

{
  "id": "msg_01j9e0m1m6fc38gsv2vkfqgzz2",
  "to": "+14155551234",
  "from": "+14155550000",
  "status": "queued",
  "surge_message_id": "msg_01j9e0m1m6fc38gsv2vkfqgzz2",
  "segments": 1,
  "credits_used": 0.516,
  "credits_remaining": 9499.6
}

{
  "error": {
    "code": "compliance_pending",
    "message": "Outbound SMS is not available yet — the carrier (10DLC) campaign is still being approved.",
    "campaign_status": "in_review",
    "retryable": true
  }
}

Sends an outbound SMS from a provisioned number. Billed per 160-char segment. Carrier-gated (not approval-gated): if the number’s campaign isn’t approved yet, the request returns 409 compliance_pending and no message is sent / no credit is charged.

Path Parameters

Parameter	Type	Description
`id`	string	UUID of the sending phone number

Request Body

Parameter	Type	Required	Description
`to`	string	Yes	Recipient phone number in E.164 format (e.g. `+14155551234`)
`body`	string	Yes	Message text

curl -X POST https://api.usenaive.ai/v1/phone/phone-uuid/sms \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "to": "+14155551234", "body": "Your order shipped!" }'

{
  "id": "msg_01j9e0m1m6fc38gsv2vkfqgzz2",
  "to": "+14155551234",
  "from": "+14155550000",
  "status": "queued",
  "surge_message_id": "msg_01j9e0m1m6fc38gsv2vkfqgzz2",
  "segments": 1,
  "credits_used": 0.516,
  "credits_remaining": 9499.6
}

{
  "error": {
    "code": "compliance_pending",
    "message": "Outbound SMS is not available yet — the carrier (10DLC) campaign is still being approved.",
    "campaign_status": "in_review",
    "retryable": true
  }
}

CLI

naive phone send --from phone-uuid --to +14155551234 --body "Your order shipped!"

MCP

Tool: naive_phone_send

{ "phone_id": "phone-uuid", "to": "+14155551234", "body": "Your order shipped!" }

Sending SMS is not approval-gated — it executes immediately (subject to the carrier-approval gate above). Only provisioning a number is approval-gated by default.

curl -X POST https://api.usenaive.ai/v1/phone/phone-uuid/sms \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "to": "+14155551234", "body": "Your order shipped!" }'

{
  "id": "msg_01j9e0m1m6fc38gsv2vkfqgzz2",
  "to": "+14155551234",
  "from": "+14155550000",
  "status": "queued",
  "surge_message_id": "msg_01j9e0m1m6fc38gsv2vkfqgzz2",
  "segments": 1,
  "credits_used": 0.516,
  "credits_remaining": 9499.6
}

{
  "error": {
    "code": "compliance_pending",
    "message": "Outbound SMS is not available yet — the carrier (10DLC) campaign is still being approved.",
    "campaign_status": "in_review",
    "retryable": true
  }
}

​Path Parameters

​Request Body

​CLI

​MCP

Path Parameters

Request Body

CLI

MCP