Skip to main content
API keys let you securely authenticate with Blnk Cloud APIs. They allow your applications, scripts, and automated workflows to interact with Blnk Cloud programmatically. You can manage your API keys in Settings > API Keys.
Keep your API keys secure and rotate them regularly. API keys provide full access to your account based on their assigned scopes. Never share API keys publicly or commit them to version control.

​
How API keys work

When you make an API call, include your API key in the request headers to verify your identity and authorize the operation on your Cloud workspace. 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 (e.g., * for all permissions, or specific scopes like mcp:read, mcp:write)
  • Expiration: Optional expiration date, or Never for keys that don’t expire

​
Create an API key

1

Open API keys

Go to Settings > API Keys.
2

Click Create API key

Click Create API key in the top-right corner of the page.
API keys page with the Create API key button highlighted
3

Configure your API key

In the Create API key panel, fill in the required details:
  • Name: A descriptive name (for example, Alerts Integration)
  • Type: API Key for server-to-server auth, or OAuth for MCP and third-party integrations
  • Expiration: Choose when the key should expire (for example, 30 days, or Never)
  • Scopes: Select the permissions this key needs
Create API key panel with name, type, expiration, and scopes
4

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 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.
2

Click Update expiration

In Quick actions, click Update expiration.
API key details panel with Update expiration highlighted in Quick actions
3

Choose a new expiration

Select a new expiration (Never expires, 7 days, 30 days, 60 days, or 90 days), then confirm your change.
Update API key expiration modal with expiration options
The key keeps working with the same secret. Only its expiration date changes.

​
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.