Create a client company attached to your reseller account
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Example payload
name, trial_end and company_setting.license_category are required. trial_end is a Unix timestamp in seconds: the company starts a Leexi trial until that date, or is created with an ended trial when the date is in the past.
{
"name": "New Client",
"reseller_external_id": "CLIENT-9",
"trial_end": 1767222000,
"company_setting": { "license_category": "business" },
"setting": { "locale": "fr-FR", "time_zone": "Europe/Paris" },
"admin": { "name": "Jane Doe", "email": "[email protected]" }
}The company is created under your reseller account with its settings and the license you choose among free, starter, ai_meeting and business: an unknown or missing license answers 422, and so does an unknown subscription_interval, subscription_currency, setting.locale or setting.time_zone.
First admin
admin is optional. When you send it, the same call creates a team named Default and the admin in it, as super admin with the license of the company, and sends them the welcome email to set their password ("send_welcome_email": false skips it). The admin is checked before anything is created, so a refused admin leaves no company behind:
- a missing
admin.nameoradmin.emailanswers400, - an invalid or undeliverable email answers
400, - an email already used by a Leexi user answers
409. A duplicatereseller_external_idanswers409too: only themessagetells them apart.
The response returns the company only: read the admin with the client users endpoint, GET .../companies/{company_uuid}/users.
Without admin, the company has no team yet: create one with the client teams endpoints before adding users.
Requires thewrite_clientspermission scope on the API key of a reseller account.
reseller_external_idmust be unique among your client companies: a duplicate answers409.
401401
402402
429429
