Skip to main content
POST
Create sub-account
Creating a sub-account does two things:
  1. It creates a new, empty Nexor account under yours, with the name, country, language, and time zone you send.
  2. It invites owner_email as the sub-account’s owner. The invitation is valid for 7 days.
The sub-account has no card, plan, or invoices of its own. Every lead it contacts counts toward your plan.

Check the invitation

owner_email cannot belong to a member of your main account (422 owner_email_is_parent_member). Owners and Admins of the main account do not need an invitation: they can open the sub-account from the app. To link a Nexor account that already exists as a sub-account, or to detach one, contact Nexor Support. The API only creates new sub-accounts. For the feature gate, scopes, and confirm, see Before you start.

Authorizations

X-API-Key
string
header
required

API key for authentication. Keys are prefixed with nxr_live_.

Body

application/json
name
string
required

Company name of the sub-account.

Required string length: 2 - 120
country
string
required

ISO 3166-1 alpha-2 country code, such as CL or US.

Pattern: ^[A-Za-z]{2}$
language
string
required

Account language: es or en.

timezone
string
required

IANA time zone, such as America/Santiago.

owner_name
string
required

Name of the person who will own the sub-account.

Maximum string length: 120
owner_email
string<email>
required

Email that receives the owner invitation. It cannot belong to a member of the main account.

confirm
enum<boolean>
required

Must be true.

Available options:
true

Response

Sub-account created.

id
string<uuid>
required

The new sub-account's ID.

name
string
required
invitation
object | null
required

The owner invitation. null means the invitation failed: the sub-account exists, so resend it.

Last modified on October 1, 2026