Allo

Send SMS (France)

Send an SMS message to a US phone number using one of your Allo phone numbers. The recipient must be in the same country as your Allo number.

POST/v1/api/sms
Why a verified Sender ID is needed

French operators block SMS sent from standard mobile numbers (+33 6xx / +33 7xx) via API. You must use an Alphanumeric Sender ID or a Short Code to send business SMS in France.

Why standard mobile numbers don't work

French operators (Orange, SFR, Bouygues Telecom, Free Mobile) prohibit using mobile numbers for business SMS. ARCEP, France's telecom regulator, formalized this ban in January 2023.

If you try to send SMS from a +33 6 or +33 7 number via API, operators block the message at the network level. Numbers that exceed volume thresholds are automatically suspended.

Allo offers two compliant alternatives: Alphanumeric Sender ID and Short Code.


Your options

Alphanumeric Sender ID

Your SMS displays a custom text name (up to 11 characters) instead of a phone number. For example, your recipients see "MOBILEFIRST" instead of +33 6 12 34 56 78.

Best for: Appointment reminders, order confirmations, payment notifications, and one-way marketing campaigns.

Formatting rules:

  • 3 to 11 characters
  • Letters (A-Z, a-z) and digits (0-9) only
  • Must contain at least one letter
  • No spaces or special characters

Key limitation: Recipients cannot reply.

Setup time: 1 to 5 business days.

Short Code (5-digit number)

A dedicated or shared 5-digit number (e.g., 36xxx for marketing, 38xxx for transactional messages).

Best for: Two-way conversations, customer service, keyword campaigns, and high-volume marketing with native STOP handling.

Key advantage: Recipients can reply.

Setup time: 2 to 4 months for a dedicated code. Days to weeks for a shared code.


French SMS compliance rules

Consent:

  • B2C: Explicit opt-in required.
  • B2B: No prior opt-in required, but the message must relate to the recipient's professional activity.

Time restrictions (marketing SMS only):

  • No marketing SMS on Sundays or French public holidays
  • No marketing SMS between 20:00 and 08:00

STOP mechanism: Every marketing SMS must include opt-out instructions.

Authorization

Authorizationstring · headerrequired

Scope needed: SMS_SEND

Body

fromstringrequired

Your Allo phone number (must be owned by your account)

tostringrequired

Recipient phone number (E.164 format, same country as 'from')

messagestringrequired

Message content

Responses

200SMS sent successfully
dataobject

Sent SMS message details

6 fields
from_numberstring | null

Phone number that sent the message. Null when sender_id is used instead.

sender_idstring | null

Sender ID used for the message (alphanumeric identifier). Only populated when sending with a verified Sender ID (e.g., for France SMS). Null when from_number is used.

to_numberstring

Phone number that received the message

typeenum<string>

Direction of the message (always OUTBOUND for sent messages)

OUTBOUND

contentstring

Content of the SMS message

start_datestring<date-time>

When the message was sent

400Bad request
codestring

Error code identifying the type of error

detailsobject[]

Additional error details, or null if not applicable

2 fields
messagestring
fieldstring
401
403
429