@canva/user

A package for Canva's Apps SDK that provides methods for getting user data and authenticating users.

Table of contents

• Introduction
• Installation
• Usage
• API reference
• Related packages
• Contributing
• License

Introduction

@canva/user is an npm package for Canva's Apps SDK. It provides methods for getting user data and authenticating users. For example, the requestAuthentication method prompts users to authenticate with the app via a third-party platform.

Note: To get up and running with the Apps SDK, check out the quick start guide.

Installation

npm install @canva/user

Usage

1. Import a method or namespace from the @canva/user package:

   import { auth } from '@canva/user';

2. Call a method, passing in the required arguments (if any):

   await auth.requestAuthentication();

API reference

• auth.getCanvaUserToken
• auth.requestAuthentication

Related packages

The Apps SDK is made up of the following packages:

• @canva/app-ui-kit - React-based component library for creating apps that mimic the look and feel of Canva.
• @canva/asset - Provides methods for working with assets, such as image and video files.
• @canva/design - Provides methods for interacting with the user's design, such as creating elements.
• @canva/error - Provides a CanvaError class for handling errors.
• @canva/platform - Provides utility methods, such as a method for opening external links.
• @canva/user - Provides methods for accessing user data and authenticating users.

Contributing

We're actively developing this package but are not currently accepting third-party contributions. If you'd like to request any changes or additions to the package, submit a feature request via the Canva Developers Community.

License

See the LICENSE.md file.