API Keys API
Manage API keys and authentication
Overview
The API Keys API allows you to programmatically manage API keys for your EventNerds account. This is useful for automation and integration workflows.
Authentication Required: These endpoints require JWT authentication from a logged-in user, not an API key. You must use your session token from the EventNerds web application.
Endpoints
List API keys
/api-keysGet a list of all API keys for the authenticated user.
Example request
curl -X GET "https://eventnerds.com/api/developer/v1/api-keys" \
-H "Authorization: Bearer JWT_TOKEN"Response
{
"success": true,
"data": [
{
"id": "uuid",
"name": "Production API Key",
"prefix": "evn_prod_",
"event_id": "uuid",
"created_at": "2025-01-15T10:00:00Z",
"last_used_at": "2025-01-16T14:30:00Z"
}
]
}Security Note: The full API key is only shown once during creation. List and get endpoints only return the key prefix for security.
Create API key
/api-keysCreate a new API key. The full key is returned only once, so make sure to save it securely.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
name | String | Yes | Descriptive name for the API key |
event_id | UUID | No | Scope key to specific event (omit for organization-wide key) |
Example request
curl -X POST "https://eventnerds.com/api/developer/v1/api-keys" \
-H "Authorization: Bearer JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Production API Key",
"event_id": "EVENT_ID"
}'Response
{
"success": true,
"data": {
"id": "uuid",
"name": "Production API Key",
"key": "evn_prod_abc123xyz789...",
"event_id": "uuid",
"created_at": "2025-01-15T10:00:00Z"
}
}Delete API key
/api-keys/{id}Delete an API key. This action cannot be undone and will immediately revoke access for any applications using this key.
Warning: Deleting an API key will immediately break any integrations using that key. Make sure to update your applications before deleting.