API Keys

API keys are the primary method for authenticating with the ListenLayer API.

Creating an API Key

1. Go to your ListenLayer Dashboard

2. Navigate to Settings > API Keys

3. Click Create New Key

4. Give your key a descriptive name

5. Copy the key (it won't be shown again)

Using Your API Key

Include your API key in the Authorization header:

curl -X GET "https://api.listenlayer.com/v1/events" \
  -H "Authorization: Bearer YOUR_API_KEY"

Key Permissions

Permission	Description
read:events	Read event data
write:events	Send events
read:users	Read user data
admin	Full access

Security Best Practices

• Never commit API keys to version control

• Use environment variables to store keys

• Rotate keys regularly

• Use the minimum required permissions