POST
Sign up with a company
No sign-in needed For: Everyone Conditions
  • No sign-in is needed; the route allows 5 calls per minute.
  • Only type user is routed.
  • The token must be a sign-up token issued by check-email for the same email address as the request, not expired and not already used; this is checked before any other field.
  • The email must be a valid address not used by any existing account, and the phone number must not be used by any existing account (accounts that were deactivated still count).
  • The password needs at least 8 characters with lower case, upper case, a digit and a symbol.
  • The company needs a type, name, currency, a country code that exists in the tax catalog (currently BJ only) and a fiscal status valid for that country. Currency defaults to XOF with exponent 0 when omitted.
What else happens
  • Creates the account (active, email not yet verified).
  • Creates a new organization named after the company, owned by the person, with its own books and the person as organization member with an administrator profile.
  • Creates the company with its default settings, its accounting set-up (books in the company currency) and the tax profile for its country and fiscal status.
  • Creates the built-in administrator and read only profiles of the company, assigns the administrator profile to the person and adds the person as company member named after their first and last name.
  • Invalidates the sign-up token and sends an email verification link (valid 1 hour); the person cannot sign in until the address is verified.
Part of Sign up and sign in.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

type
string
required

Kind of account to create. Only user is accepted: it creates a person with a new company.

Body

application/json
token
string
required

Sign-up token received in the email sent by check-email. It must have been issued for the same email address as this request, must not be expired (1 day) and is invalidated once the account is created.

first_name
string
required

First name of the new person, 3 to 250 characters.

Required string length: 3 - 250
last_name
string
required

Last name of the new person, 3 to 250 characters.

Required string length: 3 - 250
email
string<email>
required

Email address of the new account. Must be valid, must not be used by any existing account and must be the address the token was issued for. The account cannot sign in until it is verified.

phone_number
string
required

Phone number of the new account, 3 to 30 characters. Must not be used by any existing account.

Required string length: 3 - 30
password
string
required

Password of the new account: at least 8 characters with lower case, upper case, a digit and a symbol.

company
object

Company created with the account. The person becomes its administrator and owner.

Response

detail
boolean
required

Always true when the account was created.