Overview
API tokens allow you to authenticate programmatically with the Royaltyport API. Each token is scoped to either your entire organization or a specific project, and can have a configurable expiration date. Only organization Admins and Owners can create and delete tokens.The Royaltyport API is currently in closed Beta. Contact hello@royaltyport.com to get early access.
Accessing API Tokens
Go to Organization Settings
Navigate to your organization from the Dashboard, then click Settings in the navigation.
Creating a Token
Enter a token name
Give the token a unique, descriptive name so you can identify it later (e.g., “Production Integration” or “Data Export Script”).
Select a scope
Choose what this token should have access to:
Use a project-scoped token when you want to limit a token’s access to one project (e.g., for a third-party integration). Use an organization-scoped token when your workflow spans multiple projects.
| Scope | Access |
|---|---|
| Organization | Grants access to all projects within your organization |
| Specific project | Restricts access to a single named project only |
Set an expiration
Choose how long the token should remain valid:
A preview of the exact expiration date is shown below the selector.
| Option | Duration |
|---|---|
| 1 Day | Expires after 1 day |
| 7 Days | Expires after 7 days |
| 30 Days | Expires after 30 days |
| 60 Days | Expires after 60 days |
| 90 Days | Expires after 90 days |
| Never | Token does not expire |
Managing Existing Tokens
The tokens table shows all active tokens for your organization, including:| Column | Description |
|---|---|
| Name | The token’s display name |
| Created | When the token was created and when it expires |
| Scope | Either Organization (access to all projects) or the name of a specific project |
| Last active | When the token was last used to make an API request |
Deleting a Token
To delete a single token, click the … menu on any row and select Delete. Confirm in the dialog that appears.Bulk deletion
To delete multiple tokens at once, select the checkboxes next to the tokens you want to remove, then open the … menu in the table header and choose Delete selected.Permission Requirements
| Action | Required Role |
|---|---|
| View tokens | Admin, Owner |
| Create a token | Admin, Owner |
| Delete a token | Admin, Owner |
Members with the Member role cannot access organization settings and cannot manage API tokens.
Related Documentation
API Introduction
Learn how to authenticate and use the Royaltyport API.
Members & Roles
Understand organization role permissions.
General Settings
Configure your organization’s basic information.
Security
Configure SSO and audit logs.