Authentication

API Keys

Notify'n uses API keys to authenticate requests. You can create and manage API keys from your account settings.

Getting an API Key

1. 1Sign up for a Notify'n account at notifyn.net
2. 2Navigate to Settings → API Keys
3. 3Click "Create API Key" and give it a name
4. 4Copy the key immediately - it won't be shown again

Using the API Key

Include your API key in the Authorization header as a Bearer token:

Authorization: Bearer ntfn_your_api_key_here

Example Request

curl -X POST https://notifyn.net/api/v1/emails \
  -H "Authorization: Bearer ntfn_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": "user@example.com",
    "subject": "Hello World",
    "html": "<p>Hello from Notifyn!</p>"
  }'

Storing API Keys

We recommend storing your API key in an environment variable:

NOTIFYN_API_KEY=ntfn_your_api_key_here

const apiKey = process.env.NOTIFYN_API_KEY;fetch(`${API_URL}/api/v1/emails`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: 'hello@yourdomain.com',
    to: 'user@example.com',
    subject: 'Hello World',
    html: '<p>Hello from Notifyn!</p>',
  }),
});

API Key Permissions

When creating an API key, you can configure specific permissions:

Security Best Practices