Skip to main content
API keys provide programmatic access to your ColdSend account. Each key has specific scopes that determine what operations it can perform.

​
Creating an API Key

Create API keys through the ColdSend dashboard:
  1. Navigate to Settings > API Keys
  2. Click Create API Key and enter a descriptive name
  3. Select the scopes your integration needs
  4. Copy the key — it is only shown once
  5. Store it in a secrets manager or environment variable

​
Key Formats

​
Managing API Keys

The dashboard displays all API keys with:
  • Key name and associated scopes
  • Creation date and last used timestamp
  • Status (active/revoked)
Available actions:
  • View full key (only during creation)
  • Revoke key immediately
  • Delete and create new keys with different scopes
Revoked keys lose all access immediately and cannot be restored. Create a new key if needed.

​
Security Best Practices

​
Use Environment Variables

Never hardcode API keys in source code or commit to version control.

​
Separate Keys by Purpose

Create dedicated keys with minimal scopes:

​
Key Storage

ColdSend stores only a hashed version of your API key (SHA-256 with a secret pepper). The original key is never stored, meaning lost keys must be regenerated.