Authentication

Create and manage API keys for programmatic access.

Postman CollectionDownload the ready-made collection with all endpoints pre-configured.

Use with Claude, ChatGPT & moreConnect any AI assistant to BlackTwist via our MCP server. No code required.

Creating an API Key

Navigate to Settings > API Keys in your BlackTwist dashboard to create a new API key. The full key is shown only once on creation — store it securely, you will not be able to retrieve it again.

Key Format

All API keys begin with the prefix bt_api_ followed by a random string. Example:

bt_api_k729m2p4q8r1s5t3v6w0y

Using Your API Key

Include your API key in every request using one of these two header formats:

# Option 1: Authorization header
Authorization: Bearer bt_api_...

# Option 2: X-Api-Key header
X-Api-Key: bt_api_...

Example Request

curl https://blacktwist.app/api/v1/providers \
  -H "Authorization: Bearer bt_api_..."

Managing Keys

You can list and revoke API keys from the Settings > API Keys page in your BlackTwist dashboard. Create separate keys for different integrations so you can revoke them independently.

Security Best Practices

Never share your API key or commit it to version control.
Use environment variables to store the key in your applications.
Revoke keys immediately if they may have been compromised.
Create separate keys for different integrations so you can revoke them independently.

Introduction

Providers