Sign in
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

account_idstring required

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

role'owner' | 'admin' | 'partner' | 'sales_manager' | 'moderator' | 'advertiser' required

System roles accepted by legacy authorized-user mutations

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

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

Response

A successful response

idstring required

The unique identifier for the authorized user.

role'owner' | 'admin' | 'partner' | 'sales_manager' | 'moderator' | 'advertiser' | 'app_manager' | 'support' | 'manager' | 'workforce' | '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"
  }
}

Changes

Changed in 4 of the 74 revisions of this API.632

  • c19acf2e254811See the full diff
    • ●

      added the new partner enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new partner enum value to the request property

      request-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 697924df40d111See the full diff
    • ▲

      added the new required request property

      new-required-request-property

    • ●

      removed the request property

      request-property-removed

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 48408451a1f05See the full diff
    • ▲

      removed the enum value app_manager of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value custom of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value manager of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value support of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value workforce of the request property

      request-property-enum-value-removed

  • ae20b30817de11See the full diff
    • ●

      added the new workforce enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new workforce enum value to the request property

      request-property-enum-value-added

Of the 74 revisions, 1 has no diff computed.