Skip to main content

Generate a new API Token

POST 
/Accounts/:AccountSid/tokens

Generate an API Token for a project to be used to authenticate requests within the project.

Request​

Path Parameters

    AccountSid uuidrequired

    The unique identifier for the project you want to use to authenticate this request.

Body

required

    name stringrequired

    The name representing the project API token.

    Example: John Doe's Token
    permissions string[]required

    The permissions you would like to enable for this project API token. Valid permissions are calling, chat, fax, management, messaging, numbers, pubsub, storage, tasking, and video

    Example: ["calling","fax","messaging"]
    subproject_id string

    The unique identifier of the subproject you would like to create a token for. The subproject passed must be a child of the project used to authenticate the request.

    Example: 9a7fc048-984f-11ee-b9d1-0242ac120002

Responses​

OK

Schema

    id string

    The ID of the created API Token.

    Example: ea14556a-984f-11ee-b9d1-0242ac120002
    name string

    The name of the created API Token.

    Example: John Doe's Token
    permissions string[]

    The permissions enabled for this token.

    Example: ["calling","fax","messaging"]
    token string

    The API token that can be used along with the project ID for basic authentication

    Example: PT037258e533e87ac63174ee136ed0798dc85d4f4f9e6d7191