Enviar um SMS

POST

/v1/sms/send/single

Envia uma mensagem para um número. Debita o saldo da conta.
O limite de caracteres depende do provedor ativo (ex.: 160). O teto
absoluto da API é 1600. Endpoint sujeito a rate-limit (429).

Requisição

Authorization

Bearer Token

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonObrigatório

Exemplo

{
    "phone": "+5511999990000",
    "message": "Olá do SMSGo",
    "schedule": "2019-08-24T14:15:22.123Z",
    "reference": "string",
    "from": "string",
    "sms_type_id": 0
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/sms/send/single' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "phone": "+5511999990000",
    "message": "Olá do SMSGo",
    "schedule": "2019-08-24T14:15:22.123Z",
    "reference": "string",
    "from": "string",
    "sms_type_id": 0
}'

Respostas

🟢200

application/json

Envio registrado e enfileirado

Bodyapplication/json

Exemplo

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "quantity": 1,
    "status": "queued",
    "test": true
}

🟠400BadRequest

🟠401Unauthorized

🟠402PaymentRequired

🟠409Conflict

🟠422ValidationError

🟠429TooManyRequests

Modificado em 2026-07-01 17:10:11

Página anterior

Revogar o token atual

Próxima página

Enviar SMS em massa