auth.requestAuthentication

API reference for the auth.requestAuthentication method.

Starts an authentication flow.

To learn more, see Authenticating users.

import { auth } from "@canva/user";
const response = await auth.requestAuthentication();
switch (response.status) {
case "COMPLETED":
console.log("The authentication was successful.");
break;
case "ABORTED":
console.log("The user exited the authentication flow.");
break;
case "DENIED":
console.log("The user didn't have the required permissions.");
break;
}
ts
#optionsobject
Optional

The options for customizing the authentication flow.

#options.contextstring
Optional

A string that's appended to the app's Redirect URL at the start of an authentication flow.

The value of the context parameter must not:

  • Exceed 32 characters
  • Contain sensitive information, such as user data, tokens, or secrets
  • Contain anything not strictly relevant to the authentication flow

A Promise that resolves with the following object:

#resultobject
Required

The result of the authentication flow.

#result.statusstring
Required

A value that identifies if the authentication flow was successful or not.

This property may contain any of the following values:

  • "COMPLETED" - The user successfully authenticated.
  • "ABORTED" - The user exited the authentication flow.
  • "DENIED" - The user didn't have the required permissions.
#result.detailsarray
Sometimes required

An array of error codes provided by the app. The app can provide these error codes when redirecting the user back to Canva at the end of an authentication flow.