How To Create Permanent Tokens For Integrations

Summary

If you are building an integration that does not require user interaction and uses only machine-to-machine communication, you can authenticate it with permanent tokens. The tokens will not expire. If you are building a new integration, we recommend using OAuth2 Apps.

Who?

This feature/solution requires Customer Support to enable, but then individual permissions can be done by the Bynder Admin.

Don't yet have Bynder? Start Here!

Once permanent tokens are enabled, the feature can be used in your portal. Users will need the Manage Bynder permanent tokens permission to create and delete permanent tokens.

Why?

A permanent API token can be created to keep a system in sync with Bynder or to upload data, such as assets. Permanent tokens help with non-human interactions between machines. For example, a product company wants to sync its Product Information Management (PIM) metadata with Bynder asset metaproperties. Another helpful use of permanent tokens would be if a marketing team is looking for generic assets that their DAM does not include and purchases assets from stock repositories. These assets need to be uploaded to the Bynder DAM using the API.

How?

  1. Navigate to your Bynder portal.
  2. Go to Settings > Advanced Settings > Portal Settings and click Permanent Tokens.
  3. Click Add new token.

  4. Enter a description for the token in the Description field.

    perm_token_.png

  5. Select Integration from the dropdown menu.

    • If your integration does not appear in the dropdown, choose Other and type in the integration name.

      OTHER_INTEGRATION.png
  6. Click the Assigned user dropdown to assign a user's permissions to the token. Enter the user's name and click one of the returned search results.
  7. In the Scopes section, select the Bynder resources you want to access with this permanent token.
  8. Click Create token to create the token. The new permanent token will be displayed.
  9. Copy the token information; make sure you don't lose it, as it will only be displayed once and cannot be regenerated. You can now find the token in your permanent tokens overview screen. This is a permanent token and does not need to be refreshed. 

Note: The token cannot be edited after it is created. If changes are needed, create a new permanent token with the updated changes and delete the old token.

 

Deleting Permanent Tokens

  1. Navigate to your Bynder portal.
  2. Go to Settings > Advanced Settings > Portal settings and click Permanent Tokens.
  3. Click the settings wheel next to the token you want to delete.
  4. Click Delete token. A pop-up will open.
  5. Please read the warning message and click the Delete button to delete the token permanently. 
  6. The token is now deleted and can no longer be used. This action cannot be undone.

Related Articles

How To Create And Manage OAuth2 Apps

 

Updated