Our partners can get access to an API of their calendar events. This is useful for feeding event data into external services like newsletter platforms, custom apps, or internal reporting tools.
How to Access Your API Credentials
- Log in to your Evvnt marketing account.
- From the dashboard, select an active calendar.
- The left sidebar will be active now and you can click Developer.
- Your API key, API secret, and links to technical documentation are found on that page.
Tip: Each site has its own API credentials. If you manage multiple sites then make a note of what site you have selected before copying your key.
Using the Evvnt API
The Evvnt Publisher API gives you programmatic access to event data as JSON over HTTPS, authenticated with an API key and secret available for published calendar sites that are hosting an active Evvnt calendar.
The /events Endpoint
The GET /events endpoint is the main way to pull event data. By default it returns up to 20 evvnt-sourced events, but you can adjust this with a few common parameters:
- max_results — return more than the default 20 (up to 100)
- page — paginate through results beyond the max_results limit
- category_id — filter to one or more event categories
- country — restrict results to a 2-letter country code
- newer_than — only return events updated after a given timestamp
For full details on authentication, all available parameters, and response fields, visit api.evvnt.com.
Pulling Backfill Events via the API
Backfill events can be retrieved through the Publisher API, but they are excluded by default. The GET /events endpoint only returns evvnt-sourced events unless you add the all_sources=true parameter.
When working with backfill data, look for the id field source suffix — a letter suffix (e.g. the 'x' in 67890x) indicates a non-evvnt source; no suffix letter means the event is evvnt-sourced.