Coinbase Business OAuth2 Scopes

Permissions, also known as scopes with OAuth2, allow you to specify fine-grained access for your Coinbase Business (OAuth2) applications and API keys. Getting your permissions right is the key to developing safe and trustworthy applications on Coinbase’s APIs.

With OAuth2, permissions are set in the authorization URL. Some permissions, like sending funds, also requires additional settings. Unlike Coinbase Business permissions, API key permissions are defined when creating an API key and can be changes afterwards.

All authenticated endpoints, except GET /user, require a specific scope to access them. In general, permissions follow the pattern,service-name:resource:action, where the main services are wallet and data.

In general, most common actions are:

• read - List or read individual resources (e.g., listing your transactions)
• create - Create new resources. For some resources there’s more specific actions (e.g. send and refund)
• update - Update existing resource
• delete - Delete a resource

With OAuth2, permissions should be considered as grants: Users can select which permissions (scopes) they grant access to for the application. The application might need to request new scopes over the lifecycle of the authorization. To see which permissions the user has granted, you can use GET /user/auth endpoint.

As a general rule, you should only ask for scopes which your application needs and avoid asking for access to unnecessary ones. Users more readily grant access to limited, clearly described scopes.

​

Supported Scopes

Below are listed all the available scopes for both Coinbase Business application and API keys. For more information to understand which permission is required for a specific API action/endpoint, follow our API reference which includes Permissions section under each endpoint.