Passer au contenu principal
POST
Create account
Scope requis : PARTNER
Crée un compte Allo pour l’un de vos clients et lui provisionne un numéro de téléphone. La réponse renvoie une clé API dédiée au nouveau compte (affichée une seule fois), avec le(s) numéro(s) provisionné(s) et le statut.
  • number_preference.country est requis (code pays ISO, ex. FR) ; number_preference.prefix est optionnel (ex. +337).
  • Un numéro est réservé avant la création du compte — si aucun ne peut être attribué ou acheté, la requête échoue avec NO_NUMBER_AVAILABLE et rien n’est créé.
  • Le compte est facturé comme un siège sur votre abonnement ; aucun débit n’est effectué sur votre client.
  • Si l’email ou le mobile personnel appartient déjà à un compte Allo, la requête échoue avec PARTNER_ACCOUNT_ALREADY_EXISTS.

Autorisations

Authorization
string
header
requis

Corps

application/json
email
string
requis

Becomes the account's login.

name
string
requis
Exemple:

"Jane Doe"

personal_mobile
string
requis

Mandatory — an existing mobile the secondary number attaches to.

Exemple:

"+33612345678"

number_preference
object
requis
partner_client_ref
string

Your own reference for this customer. Echoed back and on the activation webhook.

Exemple:

"crm-12345"

Réponse

Account created

data
object