v2

latestOpenAPI 3.1.02026-08-05100545344.4 KB

Create a subaccount

post/subaccounts

Headers

Authorizationstring required

Bearer authentication

Request body

subaccount_namestring required

The name for the new subaccount. This should be a unique identifier that distinguishes it from other subaccounts within the main account.

user_emailstring

This is the email address of the user you wish to invite to the subaccount. When this optional parameter is filled in, a "sign in" link will be generated and sent back in the response. The user can use this link to sign in and set up their account.

twilio_account_sidstring

This is the Twilio SID of the subaccount.

twilio_auth_tokenstring

This is the Twilio Token of the subaccount.

concurrencyinteger

The maximum number of calls the subaccount can handle at the same time.

max_agentsinteger nullable

The maximum number of agents the subaccount is allowed to create. Null if no limit is set.

max_minutesinteger nullable

The maximum number of minutes allocated to this subaccount. Null if no limit is set.

max_workflow_runsinteger nullable

The maximum number of workflow runs allocated to this subaccount. Null if no limit is set.

grant_permissionsSubaccountsPostRequestBodyContentApplicationJsonSchemaGrantPermissionsItems[]

Permissions to grant to the subaccount. Duplicate values are not allowed, and any value also present in revoke_permissions is rejected by the API.

revoke_permissionsSubaccountsPostRequestBodyContentApplicationJsonSchemaRevokePermissionsItems[]

Permissions to revoke from the subaccount. Duplicate values are not allowed, and any value also present in grant_permissions is rejected by the API.

Response

200

statusstring

Whether the request was successful.