Sender IDs

List sender IDs

The names your messages can come from.

GEThttps://api.falconzo.com/v1/sms/sender-ids

Only sender IDs with "usable": true (verified) can send. Request new ones in the Falconzo app under Settings › Apps › SMS.

TRANSACTIONAL sender IDs are for messages people expect, such as order updates. PROMOTIONAL ones add an opt-out line and wait until 8 AM if sent at night.

Permission

The API key needs sender_ids.read (read sender ids). Without it the answer is 403 MISSING_SCOPE.

Request

curl -X GET "https://api.falconzo.com/v1/sms/sender-ids" \
  -H "Authorization: Bearer fz_test_YOUR_KEY"

Response

{
  "data": [
    {
      "id": "cm1snd9xyz",
      "name": "ABCSHOP",
      "type": "TRANSACTIONAL",
      "status": "APPROVED",
      "usable": true
    }
  ]
}