# Déclarer un Sender ID

> Déclare un Sender ID alphanumérique sur l'un de vos comptes, pour que le compte envoie des SMS sous le nom de sa marque plutôt que depuis un numéro. En…

`POST /v2/api/partner/accounts/{account_id}/sender_ids`

<Note>
**Scope requis :** `PARTNER`
</Note>

Déclare un Sender ID alphanumérique sur l'un de vos comptes, pour que le compte envoie des SMS sous le nom de sa marque plutôt que depuis un numéro. En France, les SMS automatisés ne peuvent pas partir d'un numéro mobile : le Sender ID est donc ce qui permet à votre logiciel d'écrire aux clients du compte. La réponse renvoie le Sender ID avec le statut `PENDING`.

## Requête

- `sender_id` est requis : 1 à 11 lettres ou chiffres, sans espace ni symbole, par exemple `PLOMBMARTIN`. Une valeur absente échoue avec `MISSING_FIELD`, tout autre format avec `SENDER_ID_INVALID_FORMAT`. Le nom doit représenter l'activité réelle du compte, voir les [règles de nommage du Sender ID](/fr/help/phone-numbers/sms-france).
- `example_content` est optionnel : un exemple de message que le compte enverra, jusqu'à 1 000 caractères. Le relecteur d'Allo le lit. Une valeur plus longue échoue avec `EXAMPLE_CONTENT_TOO_LONG`.

## Règles

- Un Sender ID n'appartient qu'à un seul compte Allo. Un nom déjà détenu par un autre compte Allo échoue avec `409 SENDER_ID_ALREADY_EXISTS`.
- Un compte détient au plus 3 Sender ID. Un quatrième échoue avec `409 MAX_SENDER_IDS_REACHED`.
- Renvoyer le même `sender_id` pour le même compte renvoie le Sender ID existant : une nouvelle tentative est sans risque.
- Vous ne pouvez déclarer des Sender ID que sur les comptes créés par votre propre clé API. Tout autre compte renvoie `404 PARTNER_ACCOUNT_NOT_FOUND`.

## Validation

Allo valide chaque Sender ID à la main, en général en 1 à 5 jours ouvrés. À la fin de la validation, Allo envoie [`partner.sender_id.validated`](/fr/docs/webhooks/event-catalog#partnersender_idvalidated) ou [`partner.sender_id.failed`](/fr/docs/webhooks/event-catalog#partnersender_idfailed) à votre propre endpoint webhook. Sans endpoint webhook, interrogez [Obtenir un Sender ID](/fr/docs/white-label/get-sender-id).

Une fois le Sender ID `VALIDATED`, le compte envoie des SMS avec lui via [Envoyer un SMS (France)](/fr/docs/sms/send-sms-france).
