GET /apps/configured

API reference for the "/apps/configured" endpoint.

When a user reaches the end of an authentication flow, an app must redirect users to the following endpoint:
https://www.canva.com/apps/configured
This redirect:
Closes the authentication pop-up window.
Reloads the app (or displays an error, if the authentication is unsuccessful).
Protects the app against cross-site request forgery (CSRF) attacks.
The app must also append the required query parameters.
To learn more, refer to Authentication.
If you're creating an app via canva.cn, redirect users to the canva.cn domain instead of canva.com.
Request
Endpoint
GET https://www.canva.com/apps/configured
Query
Properties
Property
Type
Required
Description
state
string
Yes
A token that Canva provides to the app at the start of the authentication flow. The app must return this token to Canva at the end of the authentication flow. This protects the app against Cross-Site Request Forgery (CSRF) attacks.
success
boolean
Yes
If true, Canva closes the authentication pop-up window and reloads the app. If false, Canva closes the authentication pop-up window and displays an error.
Example
https://www.canva.com/apps/configured?success=true&state=<state>

Client API - Previous

init

Next - Server API

POST /configuration

Last updated 1 month ago

Property	Type	Required	Description
`state`	string	Yes	A token that Canva provides to the app at the start of the authentication flow. The app must return this token to Canva at the end of the authentication flow. This protects the app against Cross-Site Request Forgery (CSRF) attacks.
`success`	boolean	Yes	If `true`, Canva closes the authentication pop-up window and reloads the app. If `false`, Canva closes the authentication pop-up window and displays an error.