Skip to content
API Documentation

Send Flash SMS

POST
/v2/flash-global/send
curl --request POST \
  --url https://api.contacta.mx/v2/flash-global/send \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "msg": "Hello World!", "phone": "528100001234", "sender": "AWESOMEINC", "id": "my-external-id" }'

Sends a Flash SMS using a JSON payload in the request body.

Recommended for server-to-server integrations.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”

JSON body for sending an SMS.

Media typeapplication/json
object
msg
required

GSM-encoded message (max 160 characters)

string
>= 3 characters <= 160 characters
Example
Hello World!
phone
required

E.164 destination phone number without + (11–15 digits including country code)

string
/^\d{11,15}$/
Example
528100001234
sender

Sender ID authorized by carrier (optional)

string
Example
AWESOMEINC
id

External reference ID (optional)

string
Example
my-external-id

Responses

Section titled “Responses”

200

Section titled “200”

SMS sent successfully

Media typeapplication/json
object
status
boolean
error
boolean
description
object
added_on
string format: date-time
charge
number format: float
country
object
country
string
iso_code
string
type
string
encoding
string
Allowed values: gsm unicode
id
integer
job_id
string
length
integer
message
string
number
string
segments
integer
sender
string
Example
{
  "status": true,
  "error": false,
  "description": {
    "added_on": "2023-09-20 16:47:15",
    "charge": 0.99,
    "country": {
      "country": "MEXICO",
      "iso_code": "MX",
      "type": "MOVIL"
    },
    "encoding": "gsm",
    "id": 199999,
    "job_id": "199999",
    "length": 12,
    "message": "Hello World!",
    "number": "8100001234",
    "segments": 1,
    "sender": "AWESOMEINC"
  }
}

400

Section titled “400”

Missing required parameters

Media typeapplication/json
Example
{
  "status": false,
  "error": true,
  "description": "Missing params, please verify or contact to support"
}

401

Section titled “401”

Your key auth is not valid

Media typeapplication/json
Example
{
  "status": false,
  "error": true,
  "description": "Your key auth is not valid, please check with your administrator to get the new key"
}

402

Section titled “402”

Your account doesn’t have credits available for sending

Media typeapplication/json
Example
{
  "status": false,
  "error": true,
  "description": "Your account doesn't have credits available for this, please contact your administrator"
}

406

Section titled “406”

Country or carrier not reachable or assigned to your account

Media typeapplication/json
Example
{
  "status": false,
  "error": true,
  "description": "Country or carrier not reachable or assigned to your account, please contact an administrator or support"
}

410

Section titled “410”

Failed to append to the queue, no need to resend

Media typeapplication/json
Example
{
  "status": false,
  "error": true,
  "description": "Failed to append to the queue, no need to resend"
}

411

Section titled “411”

Your account doesn’t have multi-message sending enabled

Media typeapplication/json
Example
{
  "status": false,
  "error": true,
  "description": "Your account doesn't have multi-message sending enabled, please contact your administrator"
}