Read Evenium events, guests, contacts and hotels; register guests and update contacts and statuses.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
WRITE: add a contact to the address book (name, email, company, optional custom id and fields). Does not invite them to an event (use evenium_create_guest). May create a duplicate of an existing person: search with evenium_list_contacts first. POST /contacts.
Extra contact fields as {name, value} pairs.
Your own id for this contact (later usable as `ext:<id>`).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
WRITE: add a contact to the address book (name, email, company, optional custom id and fields). Does not invite them to an event (use evenium_create_guest). May create a duplicate of an existing person: search with evenium_list_contacts first. POST /contacts.
| Argument | Type | Description |
|---|---|---|
| string | ||
| fields | array | Extra contact fields as {name, value} pairs. |
| gender | string | |
| company | string | |
| custom_id | string | Your own id for this contact (later usable as `ext:<id>`). |
| last_name* | string | |
| first_name | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"last_name"
],
"properties": {
"email": {
"type": "string",
"maxLength": 320,
"minLength": 3
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field name, e.g. FUNCTION, MOBILE_PHONE_NUMBER, ADDR_CITY, or a numeric custom-field code."
},
"value": {
"type": "string",
"maxLength": 2000
}
}
},
"maxItems": 100,
"description": "Extra contact fields as {name, value} pairs."
},
"gender": {
"enum": [
"MALE",
"FEMALE"
],
"type": "string"
},
"company": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"custom_id": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Your own id for this contact (later usable as `ext:<id>`)."
},
"last_name": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"first_name": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
}
}WRITE: invite a person to an event. Either invite an existing contact (contact_id) or create a guest from scratch (first_name, last_name, email, ...), which may also create a new contact. The optional status sets the registration status (the invitation emails of the event may follow Evenium's own rules). POST /events/{eventId}/guests.
| Argument | Type | Description |
|---|---|---|
| string | ||
| gender | string | |
| status | string | Registration status to give the guest (default chosen by Evenium). |
| company | string | |
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| last_name | string | |
| contact_id | integer | Evenium contact id of an existing contact to invite. If set, the name fields are ignored. |
| first_name | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"email": {
"type": "string",
"maxLength": 320,
"minLength": 3
},
"gender": {
"enum": [
"MALE",
"FEMALE"
],
"type": "string"
},
"status": {
"enum": [
"UNANSWERED",
"PENDING",
"CONFIRMED",
"VALID",
"RESERVED",
"OVERBOOKED",
"EXTRA",
"DECLINED",
"CANCELED"
],
"type": "string",
"description": "Registration status to give the guest (default chosen by Evenium)."
},
"company": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"last_name": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Evenium contact id of an existing contact to invite. If set, the name fields are ignored.",
"exclusiveMinimum": 0
},
"first_name": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
}
}One contact by Evenium id or `ext:<customId>`: name, gender, email, company and fields. GET /contacts/{contactId}.
| Argument | Type | Description |
|---|---|---|
| contact_id* | any | Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"contact_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`."
}
}
}The events a contact is invited to, with the contact's registration (status, post status, category) in each. Filter by event start, end or creation date. GET /contacts/{contactId}/events.
| Argument | Type | Description |
|---|---|---|
| contact_id* | any | Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`. |
| ends_after | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| ends_before | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| starts_after | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| created_after | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| starts_before | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
One event by id: title, description, dates, status, site path and its fields (type, your external id, ...). GET /events/{eventId}.
| Argument | Type | Description |
|---|---|---|
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
}
}
}One event part (session) by id: title, dates, nature, code, location and fields. GET /events/{eventId}/eventParts/{eventPartId}.
| Argument | Type | Description |
|---|---|---|
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| event_part_id* | any | Event part (session) id, from evenium_list_event_parts. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"event_part_id"
],
"properties": {
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"event_part_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,20}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Event part (session) id, from evenium_list_event_parts."
}
}
}One guest of an event, by contact id or by guest code: name, email, status, category and fields (event-only fields flagged). Optionally include REGISTRATION (registrations to sessions), PRESENCE and SIGNATURE data. GET /events/{eventId}/guests/{contactId} or /guests/guestCode/{guestCode}.
| Argument | Type | Description |
|---|---|---|
| include | array | Extra data to return. |
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| contact_id | any | The guest's contact id. Give this or guest_code. |
| guest_code | string | The guest's code at the event (e.g. D4571). Give this or contact_id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"include": {
"type": "array",
"items": {
"enum": [
"REGISTRATION",
"PRESENCE",
"SIGNATURE"
],
"type": "string"
},
"maxItems": 3,
"description": "Extra data to return."
},
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"contact_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "The guest's contact id. Give this or guest_code."
},
"guest_code": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The guest's code at the event (e.g. D4571). Give this or contact_id."
}
}
}The hotel room bookings of one guest at an event: room id, check-in and check-out dates, status. Not available on the evenium.net platform. GET /events/{eventId}/guests/{contactId}/accommodations.
| Argument | Type | Description |
|---|---|---|
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| contact_id* | any | Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"contact_id"
],
"properties": {
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"contact_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`."
}
}
}The attendance (post) status of one guest after the event: UNKNOWN, NO_SHOW or PRESENT. GET /events/{eventId}/guests/{contactId}/postStatus.
| Argument | Type | Description |
|---|---|---|
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| contact_id* | any | Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"contact_id"
],
"properties": {
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"contact_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`."
}
}
}The registration status of one guest at an event (e.g. CONFIRMED, DECLINED, CANCELED). GET /events/{eventId}/guests/{contactId}/status.
| Argument | Type | Description |
|---|---|---|
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| contact_id* | any | Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"contact_id"
],
"properties": {
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"contact_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`."
}
}
}List the contacts of the address book (id, your custom id, name, email, company and fields). Filter by name, email, company or last update. GET /contacts.
| Argument | Type | Description |
|---|---|---|
| string | Email equal to this. | |
| company | string | Company like this text. |
| last_name | string | Last name like this text. |
| first_name | string | First name like this text. |
| max_results | integer | Results per page, 1-100 (default 25). |
| first_result | integer | Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result. |
| updated_since | string | Only contacts updated after this date (RFC 3339). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Email equal to this."
},
"company": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Company like this text."
},
"last_name": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Last name like this text."
},
"first_name": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "First name like this text."
},
"max_results": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"first_result": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result."
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "Only contacts updated after this date (RFC 3339)."
}
}
}The registrations to one session: contact id, status, attendance, category and dates. With include_deleted, deleted registrations are returned too (status DELETED). GET /events/{eventId}/eventParts/{eventPartId}/registrations.
| Argument | Type | Description |
|---|---|---|
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| max_results | integer | Results per page, 1-100 (default 25). |
| first_result | integer | Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result. |
| event_part_id* | any | Event part (session) id, from evenium_list_event_parts. |
| updated_since | string | Only registrations updated after this date (RFC 3339). |
| include_deleted | boolean | Also return deleted registrations (queryMode=SYNCHRONIZE). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"event_part_id"
],
"properties": {
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"max_results": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"first_result": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result."
},
"event_part_id": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{1,20}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Event part (session) id, from evenium_list_event_parts."
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "Only registrations updated after this date (RFC 3339)."
},
"include_deleted": {
"type": "boolean",
"description": "Also return deleted registrations (queryMode=SYNCHRONIZE)."
}
}
}List the event parts (sessions, workshops, activities) of an event with title, dates, nature, code and location. Filter by title and start/end/update dates. GET /events/{eventId}/eventParts.
| Argument | Type | Description |
|---|---|---|
| title | string | Sessions whose title is like this text. |
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| ends_after | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| ends_before | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| max_results | integer | Results per page, 1-100 (default 25). |
| first_result | integer | Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result. |
| starts_after | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
List the events of the Evenium account, with id, title, dates, status and creation date. Filter by title (partial match), status and start/end/creation dates. Use an event id with the guest and session tools. GET /events.
| Argument | Type | Description |
|---|---|---|
| title | string | Events whose title is like this text. |
| status | string | FUTURE = open, DRAFT, CLOSED, ARCHIVED, CANCELED, DELETED, CLONEABLE = template. |
| ends_after | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| ends_before | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| max_results | integer | Results per page, 1-100 (default 25). |
| first_result | integer | Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result. |
| starts_after | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
List the guests (invited contacts) of an event with name, email, company, registration status (e.g. CONFIRMED, DECLINED, UNANSWERED), category and fields. Filter by status, name, email, company or last update. GET /events/{eventId}/guests.
| Argument | Type | Description |
|---|---|---|
| string | Email equal to this. | |
| status | string | Only guests with exactly this registration status. |
| company | string | Company like this text. |
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| last_name | string | Last name like this text. |
| first_name | string | First name like this text. |
| max_results | integer | Results per page, 1-100 (default 25). |
| first_result | integer | Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result. |
| updated_since |
The hotels of an event with name, group, stars, contact details and, if asked, full location and rooms. Not available on the evenium.net platform. GET /events/{eventId}/hotels.
| Argument | Type | Description |
|---|---|---|
| include | array | Extra hotel properties: location (full address), rooms (room list). |
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"include": {
"type": "array",
"items": {
"enum": [
"location",
"rooms"
],
"type": "string"
},
"maxItems": 2,
"description": "Extra hotel properties: location (full address), rooms (room list)."
},
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
}
}
}WRITE: change a contact's email, company or fields (only what you pass is sent). The change applies to the contact everywhere, including its guest records. PUT /contacts/{contactId}.
| Argument | Type | Description |
|---|---|---|
| string | ||
| fields | array | Extra contact fields as {name, value} pairs. |
| company | string | |
| contact_id* | any | Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"email": {
"type": "string",
"maxLength": 320,
"minLength": 3
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Field name, e.g. FUNCTION, MOBILE_PHONE_NUMBER, ADDR_CITY, or a numeric custom-field code."
},
"value": {
"type": "string",
"maxLength": 2000
}
}
},
"maxItems": 100,
"description": "Extra contact fields as {name, value} pairs."
},
"company": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"contact_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`."
}
}
}WRITE: set the attendance (post) status of a guest: PRESENT, NO_SHOW or UNKNOWN (for example after check-in). PUT /events/{eventId}/guests/{contactId}/postStatus.
| Argument | Type | Description |
|---|---|---|
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| contact_id* | any | Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`. |
| post_status* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"contact_id",
"post_status"
],
"properties": {
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"contact_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`."
},
"post_status": {
"enum": [
"UNKNOWN",
"NO_SHOW",
"PRESENT"
],
"type": "string"
}
}
}WRITE: set the registration status of a guest at an event (e.g. CONFIRMED, DECLINED, CANCELED). Can trigger Evenium's own workflows for that status. Read the current value first with evenium_get_guest_status. PUT /events/{eventId}/guests/{contactId}/status.
| Argument | Type | Description |
|---|---|---|
| status* | string | |
| event_id* | any | Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field). |
| contact_id* | any | Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id",
"contact_id",
"status"
],
"properties": {
"status": {
"enum": [
"UNANSWERED",
"PENDING",
"CONFIRMED",
"VALID",
"RESERVED",
"OVERBOOKED",
"EXTRA",
"DECLINED",
"CANCELED"
],
"type": "string"
},
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"contact_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`."
}
}
}| created_before |
| string |
| RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"contact_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium contact id (e.g. 1102365; the guest's contactId), or `ext:<your own customId>`."
},
"ends_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"ends_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"starts_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"created_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"starts_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"created_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
}
}
}| starts_before | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| updated_after | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| updated_before | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"title": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Sessions whose title is like this text."
},
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"ends_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"ends_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"max_results": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"first_result": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result."
},
"starts_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"starts_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"updated_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"updated_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
}
}
}| created_after | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| starts_before | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
| created_before | string | RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"title": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Events whose title is like this text."
},
"status": {
"enum": [
"FUTURE",
"DRAFT",
"CLOSED",
"ARCHIVED",
"CANCELED",
"DELETED",
"CLONEABLE"
],
"type": "string",
"description": "FUTURE = open, DRAFT, CLOSED, ARCHIVED, CANCELED, DELETED, CLONEABLE = template."
},
"ends_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"ends_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"max_results": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"first_result": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result."
},
"starts_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"created_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"starts_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
},
"created_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "RFC 3339 date or date-time, UTC preferred, e.g. 2026-10-01Z or 2026-10-01T09:00:00Z (without a timezone Evenium uses Central European Time)."
}
}
}| string |
| Only guests updated after this date (RFC 3339). |
| updated_until | string | Only guests updated until this date (RFC 3339). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"event_id"
],
"properties": {
"email": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Email equal to this."
},
"status": {
"enum": [
"UNANSWERED",
"PENDING",
"CONFIRMED",
"VALID",
"RESERVED",
"OVERBOOKED",
"EXTRA",
"DECLINED",
"CANCELED",
"DELETED",
"REPLACED"
],
"type": "string",
"description": "Only guests with exactly this registration status."
},
"company": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Company like this text."
},
"event_id": {
"anyOf": [
{
"type": "string",
"maxLength": 200,
"minLength": 1
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Evenium event id (e.g. 12458), or `ext:<your own event id>` (the EXT_EVENT_ID field)."
},
"last_name": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Last name like this text."
},
"first_name": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "First name like this text."
},
"max_results": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"first_result": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Index of the first result, from 0 (default 0). Pass the previous reply's next_first_result."
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "Only guests updated after this date (RFC 3339)."
},
"updated_until": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?)?(?:Z|[+-]\\d{2}:\\d{2})?$",
"maxLength": 40,
"description": "Only guests updated until this date (RFC 3339)."
}
}
}