---
title: "Create account"
method: POST
path: "/v2/api/partner/accounts"
tags: ["Partner"]
---

# Create account

`POST /v2/api/partner/accounts`

Creates an Allo account for one of your customers, provisions a phone number, and returns a scoped API key for the account. Requires the `PARTNER` scope. The account is billed as one seat on your subscription.

## Request body

- object
  - `email` string, required — Becomes the account's login.
  - `name` string, required
  - `personal_mobile` string, required — Mandatory — an existing mobile the secondary number attaches to.
  - `partner_client_ref` string — Your own reference for this customer. Echoed back and on the activation webhook.
  - `number_preference` object, required
    - `country` string, required — ISO country code.
    - `prefix` string, nullable

## Response `201`

Account created

- object
  - `data` object
    - `id` string
    - `api_key` string, nullable — Scoped API key for the new account. Returned only on create.
    - `phone_numbers` string[]
    - `status` string
    - `activated` boolean — True once the customer has signed in on a device.
    - `partner_client_ref` string, nullable

## Other responses

- `400` — Invalid request parameters
- `401` — Invalid or missing API key
- `402` — Billing error — could not add a seat to your subscription (PARTNER_SUBSCRIPTION_NOT_BILLABLE / PARTNER_BILLING_FAILED).
- `403` — The API key lacks the PARTNER scope.
- `409` — An account already exists (PARTNER_ACCOUNT_ALREADY_EXISTS) or no number is available (NO_NUMBER_AVAILABLE).
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) · [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withallo/allo-api/revisions/9aab4db82933/schema)