API Keys

To authenticate your API requests to Emalc, you need to generate an API key from your dashboard or organizational settings.

Getting your first API key#

1. Navigate to Settings > API Keys in your Emalc dashboard.
2. Click Create API Key.
3. Provide a memorable name (e.g. Production Mailer).
4. Select the permissions scope needed for your application.
5. Copy and securely store the generated secret key.

Using the API key#

Include your key in the Authorization header of every HTTP request:

curl -X POST https://api.emalc.com/v1/emails \
  -H "Authorization: Bearer emalc_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"to": "user@example.com", "subject": "Hello"}'

Security best practices#

• Never commit your API keys into version control or client-side bundles.
• Use environment variables (e.g., EMALC_API_KEY) to load keys dynamically.
• Rotate keys periodically or immediately if you suspect a leak.