By using the API key, API requests can be done by simply having the key in the Authorization header.

Note: To be efficient, many endpoints should be used with the correct query parameters. For inspiration, follow samples of how our application (app.evenito.com) does API calls or request for a more personalized documentation from evenito.

Pagination

All get many endpoints are paginated to return maximum 300 entities in a single call.

Required headers

Authorization: Bearer {token / API key}
evenito-space-id: {spaceId}

Api keys are meant to improve the ease of API access and the maintenance and rotation of API access keys. API tokens do not expire, therefore the rotation can be determined by the users themselves.

Retrieve a normal user key

The bearer token from your user can be retrieved by taking a look into the network tab when logged in as a space_administrator in the space that you want to create an api key for.

This token has a very limited lifetime so if it runs out by the time you have prepared the API call to create your API then grab a new one from the browser. As the next step do a POST call to the API keys endpoint with this token in order to add a permanent API key.

If you have past data in evenito already, then this step is for the initial backfill of all contact data

Get all events as a first step

Request (Reference):

curl 'https://api.app.evenito.com/spaces/{space_id}/events?page=1&limit=10&s={"$and":[{"parent_id":{"$isnull":true}},{"status":{"$ne":"archived"}}]}' \
  -H 'authorization: Bearer ey...' \
  -H 'evenito-space-id: {space_id}' \

Note that without {"parent_id":{"$isnull":true}} also schedules from within events are returned.

Response:

{
    "error": false,
    "data": [
        {events listed here},
        ],
    "count": 4,
    "total": 4,
    "page": 1,
    "pageCount": 1
}

After getting all events, the contacts need fetching per event.

Get all contacts from an event, per event

Request (Reference):

curl 'https://api.app.evenito.com/events/{event_id}/contacts?page=1&limit=300' \
  -H 'accept-version: 2' \
  -H 'authorization: Bearer ey...' \
  -H 'evenito-space-id: {space_id}' \

The recommended option after a backfill or if no backfill needed

Keeping your system up to date with the changes happening in evenito

This fetches all changes over the entire space since the timestamp, up to 24h into the past maximum. Please call this endpoint on an interval not more frequent than once every few minutes, at least daily.

This sample request gets all contact creations and changes, ensuring the latest information. As it's a log of changes one contact may appear in it multiple times - therefore be careful about creating duplicates. Request (Reference):

curl 'https://api.app.evenito.com/spaces/{space_id}/change-log?fields=ts,entity,action,previous_value,current_value&s={"$and":[{"ts":{"$gt":"2025-02-13T13:00:00.000Z"}},{"entity":{"$in":["contacts"]}},{"action":{"$in":["UPDATE","INSERT"]}}]}'\
-H 'Authorization: Bearer ey...' \
-H 'evenito-space-id: {space_id}'

Response:

{
   "error":false,
   "data":[
     list of changes here, with the data that was requested with the fields parameter
   ],
   "count":14,
   "total":null,
   "page":1,
   "pageCount":null
}

Create a new event

It is always recommended to use templates or other events for creating new events. To do this, check for the ID of the event you need (Templates and Events references) and use that for creating a new one using the following payload.
Request:

curl -L 'https://api.app.evenito.com/spaces/{space-id}/events/{template or event-id}/copy' \
-H 'authorization: Bearer ey...' \
-H 'content-type: application/json' \
-H 'evenito-space-id: 74a95ce2-4ef1-4794-a606-9973828dd860' \
-d '{
    "name": "Apero Tournament mit Golf - Juni",
    "overrides": {
        "team_ids": [
            "a5c78e02-c7a3-4f3d-9359-9ce3ff73ec36"
        ]
    },
    "replacers": {
        "start_timestamp": {
            "value": "2026-06-01T09:30:00.000Z",
            "type": "date"
        }
    },
    "template": false
}'

Bulk uploading contacts into events

Request (Reference):

curl 'https://api.app.evenito.com/events/{eventId}/contacts/bulk' \
  -H 'accept: application/json, text/plain, */*' \
  -H 'accept-version: 2' \
  -H 'authorization: Bearer ey...' \
  -H 'content-type: application/json' \
  -H 'evenito-space-id: {space_id}' \
  --data-raw '{"bulk":
                [
                    {"language":"de","data":{"firstName":"test1","lastName":"test1","email":"test1@test.com"}},
                    {"language":"en","data":{"firstName":"test2","lastName":"test2","email":"test2@test.com"}}
                ]
            }'

The response will include all uploaded contacts.