Skip to main content

Access Tokens

By default, data packages are private. When you submit a data package query, the library will try to locate a session credential on your local machine that was created when you ran dpm login.

Access Tokens are long-lived service tokens from contexts besides your local computer, such as the server powering an online application.

Create an Access Token

To create an Access Token, navigate to the Tokens page in the dpm web application.

Token screen

  1. Provide a readable name, such as "purchase-enrichment-service".
  2. Select the data package you'd like to authorize

Use an Access Token

When you've successfully created the Access Token, it will be displayed on a modal.

Token created


The token will only be displayed once! Be sure to save it in a secure, accessible place or as a DPM_AUTH_TOKEN environment variable.

In the context where you'd like to submit queries, assign the token as the value of an environment variable called DPM_AUTH_TOKEN. When queries are executed from the data package, the client will retrieve the value and pass it to the dpm-agent for authorization checks.