Generate an access token

Generate access tokens to access the Connect APIs.

This endpoint implements the OAuth 2.0 token endpoint, as part of the Authorization Code flow with Proof Key for Code Exchange (PKCE). For more information, see Authentication.

To generate an access token, you must provide one of the following:

  • An authorization code
  • A refresh token

Generating a token using either an authorization code or a refresh token allows your integration to act on behalf of a user. You must first obtain user authorization and get an authorization code.

Access tokens may be up to 4 KB in size, and are only valid for a specified period of time. The expiry time (currently 4 hours) is shown in the endpoint response and is subject to change.

Endpoint authentication

Requests to this endpoint require authentication with your client ID and client secret, using one of the following methods:

  • Basic access authentication (Recommended): For basic access authentication, the {credentials} string must be a Base64 encoded value of {client id}:{client secret}.
  • Body parameters: Provide your integration's credentials using the client_id and client_secret body parameters.

This endpoint can't be called from a user's web-browser client because it uses client authentication with client secrets. Requests must come from your integration's backend, otherwise they'll be blocked by Canva's Cross-Origin Resource Sharing (CORS) policy.

Generate an access token using an authorization code

To generate an access token with an authorization code, you must:

  • Set grant_type to authorization_code.
  • Provide the code_verifier value that you generated when creating the user authorization URL.
  • Provide the authorization code you received after the user authorized the integration.

Generate an access token using a refresh token

Using the refresh_token value from a previous user token request, you can get a new access token with the same or smaller scope as the previous one, but with a refreshed expiry time. You will also receive a new refresh token that you can use to refresh the access token again.

To refresh an existing access token, you must:

  • Set grant_type to refresh_token.
  • Provide the refresh_token from a previous token request.
POST https://api.canva.com/rest/v1/oauth/token

This endpoint uses HTTP basic access authentication and requires no scopes.

#Authorizationstring
Optional

Provides credentials to authenticate the request, in the form of basic access authentication.

For example: Authorization: Basic {credentials}

#Content-Typestring
Required

Indicates the media type of the information sent in the request. This must be set to application/x-www-form-urlencoded.

For example: Content-Type: application/x-www-form-urlencoded

#grant_typestring
Required

This can be one of the following:

  • authorization_code: For exchanging an authorization code for an access token.
  • refresh_token: For generating an access token using a refresh token.
#code_verifierstring
Sometimes required

The code_verifier value that you generated when creating the user authorization URL.

#codestring
Sometimes required

The authorization code you received after the user authorized the integration.

#refresh_tokenstring
Sometimes required

The refresh token to be exchanged. You can copy this value from the successful response received when generating an access token.

#client_idstring
Optional

Your integration's unique ID, for authenticating the request.

#client_secretstring
Optional

Your integration's client secret, for authenticating the request. Begins with cnvca.

#redirect_uristring
Optional

Only required if a redirect URL was supplied when you created the user authorization URL.

Must be one of those already specified by the client. If not supplied, the first redirect_uri defined for the client will be used by default.

#scopestring
Optional

Optional scope value when refreshing an access token. Separate multiple scopes with a single space between each scope.

The requested scope cannot include any permissions not already granted, so this parameter allows you to limit the scope when refreshing a token. If omitted, the scope for the token remains unchanged.

Examples for using the /v1/oauth/token endpoint:

curl --request POST 'https://api.canva.com/rest/v1/oauth/token' \
--header 'Authorization: Basic {credentials}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=authorization_code' \
--data-urlencode 'code_verifier=i541qdcfkb4htnork0w92lnu43en99ls5a48ittv6udqgiflqon8vusojojakbq4' \
--data-urlencode 'code=kp8nnroja7qnx00.opyc1p76rcbyflsxbycjqfp3ub8vzsvltpzwafy9q5l45dn5fxzhe7i7a6mg1i2t8jpsa6sebdeumkzzhicskabgevrxsssec4dvjwfvhq4gs3ugghguar0voiqpfb7axsapiojoter8v3w2s5s3st84jpv2l06h667iw241xngy9c8=vu1tnjp7sz' \
--data-urlencode 'redirect_uri=https://example.com/process-auth'
sh

If successful, the endpoint returns a 200 response with a JSON body with the following parameters:

#access_tokenstring

The bearer access token to use to authenticate to Canva Connect API endpoints. If requested using a authorization_code or refresh_token, this allows you to act on behalf of a user.

#refresh_tokenstring

The token that you can use to refresh the access token.

#token_typestring

The token type returned. This is always Bearer.

#expires_ininteger

The expiry time (in seconds) for the token.

#scopestring
Optional

The scopes that the token has been granted.

{
"access_token": "JagALLazU0i2ld9WW4zTO4kaG0lkvP8Y5sSO206ZwxNF4E1y3xKJKF7TzN17BXTfaNOeY0P88AeRCE6cRF7SJzvf3Sx97rA80sGHtFplFo",
"refresh_token": "JABix5nolsk9k8n2r0f8nq1gw4zjo40ht6sb4i573wgdzmkwdmiy6muh897hp0bxyab276wtgqkvtob2mg9aidt5d6rcltcbcgs101",
"token_type": "Bearer",
"expires_in": 14400,
"scope": "asset:read design:meta:read design:permission:read folder:read"
}
json