Notifications

Send an SMS message from the workspace's provisioned phone number

Send an SMS from the workspace's active Twilio phone number. Billed per segment — 160 chars/segment for ASCII, 70 chars for Unicode. A phone number must be provisioned first (blink phone buy or blink.new/settings). Each message is stored for audit purposes.

post/api/v1/sms/send

Request

  • Base URL
    https://core.blink.new
  • URL
    https://core.blink.new/api/v1/sms/send
  • Auth
    HTTP bearer

Request body

tostring required

Recipient phone number in E.164 format

messagestring required

Message body.

fromstring

Specific sender number (E.164) to use when the workspace owns multiple numbers. Defaults to the workspace's oldest active number.

Example request

{
  "to": "+14155551234",
  "message": "Hello from Blink!",
  "from": "+12025551234"
}

Response

SMS sent successfully

message_idstring

Blink-internal SMS ID

twilio_sidstring

Twilio message SID for delivery tracking

statusstring

Delivery status from the SMS provider

tostring
fromstring
segment_countinteger

Number of SMS segments consumed

credits_chargednumber

Credits deducted from the workspace balance

Example response

{
  "message_id": "sms_a1b2c3d4",
  "twilio_sid": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "status": "queued",
  "to": "+14155551234",
  "from": "+12025551234",
  "segment_count": 1,
  "credits_charged": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.