Authorization and Authentication

The OAuth 1.0 Protocol with header authentication is used to provide authorized access to the API.

That means you will need pairs of consumer and token key/secret to perform calls to the API. Authentication is embedded in the token key/secret pair.

Your ultimate goal is to understand how you should create an authorization header to make a successful request.

Consumers and Tokens

Since OAuth 1.0 is being used, a consumer key and secret are required. A consumer is used for creating your tokens. In order to create it you have to have access to the bynder portal as administrator.

In addition to the consumer, you will also need a token key and secret. A token is coupled with a consumer and a user of the portal. Thus the actions that can performed in the API are also bound to the permissions of the token's user.

Types of Tokens

There are two different types tokens:

Create a Consumer

Follow the steps below to create a new consumer:

  1. Go to your-bynder-domain/pysettings (for example https://company.bynder.com/pysettings).
  2. Click on the API tokens link.
  3. Click on +Create new consumer.
  4. Enter a name for the new consumer and click Create.
  5. Copy the consumer key and consumer secret to your clipboard.
  6. Your consumer has been created. Once you have saved the information, click OK.

Create a Token

Create a permanent Access Token for a user

Follow the steps below:

  1. Go to your-bynder-domain/pysettings (for example https://company.bynder.com/pysettings).
  2. Click on the API tokens link.
  3. Click on +Create new token.
  4. Select the user you want to attach to your token (start typing for results to appear).
  5. Select the consumer you want to use and click Create.
  6. Copy the token key and token secret to your clipboard.
  7. Your token has been created. Once you have saved the information, click OK.

Create a temporary Access Token for a user

Follow these instructions.