Sign in

v8

latestOpenAPI 3.1.02026-08-033623795.0 MB
Authorized users

Create authorized user

Add a new authorized user to a company.

Required permissions:

  • authorized_user:create
  • member:email:read
post/authorized_users

Request body

company_idstring required

The ID of the company to add the authorized user to.

role'owner' | 'admin' | 'sales_manager' | 'moderator' | 'advertiser' | 'app_manager' | 'support' | 'manager' | 'custom' required

Possible roles an authorized user can have

send_emailsboolean nullable

Whether to send notification emails to the user on creation.

user_idstring required

The ID of the user to add as an authorized user.

Example request

{
  "company_id": "biz_xxxxxxxxxxxxxx",
  "user_id": "user_xxxxxxxxxxxxx"
}

Response

A successful response

idstring required

The unique identifier for the authorized user.

role'owner' | 'admin' | 'sales_manager' | 'moderator' | 'advertiser' | 'app_manager' | 'support' | 'manager' | 'custom' required

Possible roles an authorized user can have

Example response

{
  "company": {
    "id": "biz_xxxxxxxxxxxxxx",
    "title": "Pickaxe"
  },
  "id": "ausr_xxxxxxxxxxxxx",
  "user": {
    "email": "john.doe@example.com",
    "id": "user_xxxxxxxxxxxxx",
    "name": "John Doe",
    "username": "johndoe42"
  }
}