Skip to Content
SettingsDeveloperAPI Keys

API Keys

API keys let you integrate Aeternitychat with external systems programmatically.

Accessing API Keys

Go to Settings > Developer > API Keys.

Creating an API Key

  1. Click Create API Key
  2. Configure:
    • Name — A descriptive name (e.g., “My App Prod”, “CRM Integration”)
    • Expiry Date — Optional expiration date. Leave blank for a key that never expires.
    • Scopes — Select which API operations this key can perform (e.g., outbound_message, inbound_message, contact_management)
  3. Copy the generated key immediately

API keys are shown only once when created. Copy and store the key securely — you won’t be able to see it again.

Using API Keys

Include your API key in the request headers when making API calls to Aeternitychat:

Authorization: Bearer YOUR_API_KEY

API Keys Table

The keys table shows:

ColumnDescription
NameThe key’s descriptive name
Key PrefixFirst few characters of the key (for identification)
ScopesPermission badges showing what the key can access
StatusActive (green) or Revoked (gray)
ExpiresExpiration date, or “Never”
ActionsEdit or revoke the key

Managing Keys

From the API Keys page, you can:

  • Edit a key’s name, expiry, or scopes
  • Revoke keys you no longer need (with confirmation dialog)
  • Copy the full key to clipboard (only shown once at creation)

Security

  • Rotate keys periodically for security
  • Delete unused keys
  • Never share API keys in public repositories or client-side code