Skip to main content
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"

interval
enum<string>
requis

Billing interval for the account's seat on your subscription.

Options disponibles:
MONTHLY,
YEARLY
Exemple:

"MONTHLY"

number_preference
object
requis
personal_mobile
string | null

Optional — an existing mobile the new number can attach to.

Exemple:

"+33612345678"

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