Skip to main content

API token

API token method uses a fixed API token created in the signer user profile. The API token is required for authorization in Postman with almost every API call. You do not require any further login information.

Authenticate with an API token

To authenticate with an API token:

The API tokens have the same permissions and scope as the administrator who creates them.

Note

To create API tokens, an administrator needs the Account Manager > View user permission. See DigiCert ONE access.

  1. Sign in to DigiCert ONE with your signer credentials.

  2. In DigiCert ONE, in the top menu on the right, select the person icon > Admin Profile.

  3. On the Admin page, in the API Tokens section, select Create API token.

  4. On the Create API token page, add the details as needed:

    1. Name

      Enter a name for the API token. This name is the display name on the API token cards. The name must be unique and only include letters, numbers, spaces, dashes, and underscores.

    2. End date (optional)

      Adding an end date is not required. The end date is in UTC. For example, if you select 12 August 2023 as your end date, your API token expires on 12 August 2023 at 23:59:59 UTC.

      Note

      If you add an end date, make sure to note when the API token expires. You must update all API integrations using the API token before it expires. If you don't, the API token integrations will stop working.

      You can always edit the API token details and extend the expiration date before it expires.

  5. Select Create.

  6. On the Congratulations page, copy the API token and save it in a secure location so you can use it later.

    Important

    The API token is only displayed only once. You cannot access it after you select Finish. If you ever lose the API token, you'll need to delete the lost token and create a new one.

  7. After you save the token, select Finish.

  1. Open Postman.

  2. In the Postman window, select Environments (left-hand side menu) > PDF Service 2.0 Environment.

  3. Enter your API token in the “api_key” variable Current Value field.

  4. Select Save icon (top right).