Skip to main content
POST
/
v1
/
platform
/
phone-numbers
/
sms
/
send-to-number
Send an SMS
curl --request POST \
  --url https://api-sandbox.finogates.com/v1/platform/phone-numbers/sms/send-to-number \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_number": "<string>",
  "to_number": "<string>",
  "body": "<string>",
  "from_user_id": "<string>",
  "product_code": "<string>"
}
'
{
  "status_code": 123,
  "data": "<unknown>",
  "query_generated_time": 123
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Send an SMS from one of the caller's assigned Twilio numbers to any E.164 destination.

from_number
string
required

Twilio number to send from (must be assigned and active for from_user_id)

Required string length: 6 - 40
to_number
string
required
Required string length: 6 - 40
body
string
required
Required string length: 1 - 1600
from_user_id
string | null

UUID of the user whose number is used as sender. Defaults to the authenticated user.

product_code
string | null

Response

Successful Response

Standard response wrapper for single-object responses and errors.

Generic over the payload type. A route that declares CommonResponse[SomeModel] gets the real data schema rendered in OpenAPI/Swagger; a bare CommonResponse leaves data untyped.

status_code
integer
required

HTTP status code for the response.

data
any
required

Payload or error details.

query_generated_time
integer
required

UTC timestamp (milliseconds since epoch) when response was generated.