Skip to main content
You can authenticate with Blnk Cloud APIs using API keys or OAuth. To create and manage your API keys, Settings > API Keys.
API keys for Cloud APIs are different from API keys for Blnk Core. If calling the Core API directly, you’ll need to set up your API keys directly in Core.

​
How Cloud API keys work

When you make a Cloud API call, send the key in the Authorization: Bearer CLOUD_API_KEY header. The base URL is https://api.cloud.blnkfinance.com. Self-hosted Cloud under the Production License use ENTERPRISE_PUBLIC_URL. Each API key has:
  • Name: A user-friendly identifier to help you organize and identify keys.
  • Key prefix: A partial identifier visible in the API keys list (e.g., blnk_fdb796a5...).
  • Scopes: Permissions that define what the key can access, for example *, mcp:read, mcp:write, etc.
  • Expiration: Optional expiration date, or Never for keys you don’t want to expire.

​
Create an API key

1

Go to settings

Go to Settings > API Keys. Click Create API key in the top-right corner of the page.
API keys page with the Create API key button highlighted
2

Configure your API key

In the Create API key panel, fill in the required details:
  • Name: A descriptive name. Best to use the name of the user or integration that will be using the key, e.g. alerts integration, Emily Blunt, etc.
  • Type: Select API Key.
  • Expiration: Choose when the key should expire
  • Scopes: Select the permissions this key needs
Create API key panel with name, type, expiration, and scopes
3

Save and copy your API key

Click Create API key. The full key is shown only once on the Save your API key screen. Copy it and store it securely before clicking Done.
Save your API key panel showing the full key and expiration details
You cannot retrieve the full API key after creation. If you lose the key, you must void the key and create a new one.

​
Update expiration

You can change when an API key expires without creating a new key.
1

Open API key details

Click an API key name in the API Keys table to open its details panel. In Quick actions, click Update expiration.
API key details panel with Update expiration highlighted in Quick actions
2

Choose a new expiration date

Select a new expiration date, then confirm your change. The key keeps working with the same secret. Only its expiration date changes.
Update API key expiration modal with expiration options

​
Revoke an API key

If you need to disable an API key without deleting it permanently, you can revoke it. Revoked keys cannot be used for authentication but remain visible in your API keys list for reference.
1

Open API key details

Click the API key name in the API Keys table to view its details.
2

Revoke the key

In the API key details panel, click Revoke.
Revoking a key will immediately disable it. Any applications or scripts using this key will stop working until you create and configure a new one.
3

Confirm revocation

Confirm that you want to revoke the key. The key’s status will change to Revoked in the API Keys table.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.