Skip to main content

​
Overview

Use this quickstart to create a key and make your first request in minutes.

Rate limits

All API keys are limited to 1,000 requests per day. Contact us if you need higher limits.

​
1) Create an API key

1

Enable developer mode

Navigate to your Evento settings and enable Developer Mode in your profile settings.
2

Access API keys section

Once Developer Mode is enabled, go to Settings → Developer → API Keys.
3

Create new API key

Click “Create API Key” and provide a descriptive name for your key (e.g., “Production App”, “Development”, “MCP Server”).
4

Copy your key

Your API key will be displayed only once. Copy it immediately and store it securely.
You cannot retrieve the key again after closing the dialog. If you lose it, you’ll need to create a new one.

​
2) Make your first request

curl https://evento.so/api/public/v1/events/evt_abc123 \
  -H "x-evento-api-key: YOUR_API_KEY"
If the event exists and is public, the response includes success: true and an event object in data.

​
3) Key management

​
Key limits

  • Maximum of 10 active API keys per user
  • Each key can be named for easy identification
  • Keys can be revoked at any time

​
Revoking keys

If a key is compromised or no longer needed:
1

Navigate to API keys

Go to Settings → Developer → API Keys
2

Find the key

Locate the key you want to revoke in the list
3

Revoke

Click the “Revoke” button next to the key. This action is immediate and irreversible.
Revoking a key will immediately invalidate all requests using that key. Make sure to update your applications before revoking keys in production.

​
4) Security best practices

Never commit keys

Don’t commit API keys to version control. Use environment variables instead.

Rotate regularly

Create new keys and revoke old ones periodically to maintain security.

Use separate keys

Use different keys for development, staging, and production environments.

Monitor usage

Check your API key usage regularly in the developer dashboard.

​
Next steps

Authentication

Learn how to use your API key in requests

API overview

Explore available API endpoints

Get /events/{eventId}

Start with the core event details endpoint.