# Evenium

Evenium is an all-in-one event management platform that simplifies the planning, execution, and analysis of professional events.

- **Category:** event management
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `EVENIUM`
- **Version:** 20260227_00

## Tools

### Create Contact

**Slug:** `EVENIUM_CREATE_CONTACT`

Tool to create a new contact in the Evenium address book. Use when you need to add a new contact with basic information (name, email, company) and optional custom fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Contact's email address. Should be a valid email format. |
| `fields` | array | No | Array of custom fields with name/value pairs for additional contact information. |
| `gender` | string ("MALE" | "FEMALE") | No | Gender options for contact. |
| `company` | string | No | Name of the company the contact is associated with. |
| `customId` | string | No | External or custom contact ID for integration purposes. |
| `lastName` | string | No | Contact's last name. |
| `firstName` | string | No | Contact's first name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Contact

**Slug:** `EVENIUM_DELETE_CONTACT`

Tool to permanently remove a contact from the Evenium address book. Use when you need to delete a contact by their ID. WARNING: This operation is irreversible and deletes all associated guests in cascade.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contactId` | string | Yes | Unique identifier of the contact to delete. WARNING: This operation is irreversible and will delete all associated guests in cascade. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact

**Slug:** `EVENIUM_GET_CONTACT`

Tool to retrieve a single contact by ID from Evenium. Use when you need to fetch details for a specific contact using either Evenium internal ID or custom external ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contactId` | string | Yes | Contact ID - can be Evenium internal ID (e.g., '123456' or 'id:123456') or custom/external ID (e.g., 'ext:TE567890'). Use 'ext:' prefix for custom IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact by Custom ID

**Slug:** `EVENIUM_GET_CONTACT_BY_CUSTOM_ID`

Tool to retrieve a specific contact from Evenium by their custom ID (external database ID). Use when you need to look up a contact using an identifier from your own CRM or database system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `customId` | string | Yes | Custom ID specific to your database or CRM system. This is an external identifier you use to reference contacts in your own system. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact Events

**Slug:** `EVENIUM_GET_CONTACT_EVENTS`

Tool to retrieve all events that a contact has been invited to or registered for. Use when you need to see a contact's event history with registration details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contactId` | string | Yes | Contact ID to retrieve events for. |
| `endsAfter` | string | No | Filter events with endDate after this timestamp (RFC 3339 format). |
| `endsBefore` | string | No | Filter events with endDate before this timestamp (RFC 3339 format). |
| `startsAfter` | string | No | Filter events with startDate after this timestamp (RFC 3339 format). |
| `createdAfter` | string | No | Filter events with creationDate after this timestamp (RFC 3339 format). |
| `startsBefore` | string | No | Filter events with startDate before this timestamp (RFC 3339 format). |
| `createdBefore` | string | No | Filter events with creationDate before this timestamp (RFC 3339 format). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact Events by Custom ID

**Slug:** `EVENIUM_GET_CONTACT_EVENTS_BY_CUSTOM_ID`

Retrieves all events a contact has been invited to using their custom ID. Use this when you need to find all events associated with a specific contact identified by a custom ID from your database.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `customId` | string | Yes | Custom ID specific to your database used to identify the contact. |
| `endsAfter` | string | No | Filter events ending after this date (ISO 8601 format or date string). |
| `endsBefore` | string | No | Filter events ending before this date (ISO 8601 format or date string). |
| `startsAfter` | string | No | Filter events starting after this date (ISO 8601 format or date string). |
| `createdAfter` | string | No | Filter events created after this date (ISO 8601 format or date string). |
| `startsBefore` | string | No | Filter events starting before this date (ISO 8601 format or date string). |
| `createdBefore` | string | No | Filter events created before this date (ISO 8601 format or date string). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contacts

**Slug:** `EVENIUM_GET_CONTACTS`

Tool to retrieve a list of contacts from Evenium. Use when you need to fetch and optionally filter organizer contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-indexed). Defaults to 1. |
| `order` | string | No | Field name to sort results by (e.g., 'lastName', 'firstName', 'email'). |
| `search` | string | No | Search term to filter contacts by name, email, or other fields. |
| `pageSize` | integer | No | Number of contacts to return per page. Defaults to 10. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Events

**Slug:** `EVENIUM_GET_EVENTS`

Retrieves a paginated list of events from Evenium with optional filtering and sorting. Use this to list all events or search for specific events by title, code, or location. Supports pagination via start/limit parameters and sorting via sort/direction parameters. By default, returns active events only; use filter flags to include archived, deleted, or draft events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string | No | Field to sort results by. Common options: 'beginDate' (event start date), 'title' (event name), 'code' (event code). |
| `limit` | integer | No | Maximum number of events to retrieve. |
| `start` | integer | No | Zero-based index of the first event to retrieve for pagination. |
| `search` | string | No | Search term to filter events by title, code, or location. |
| `archived` | boolean | No | If true, only archived events are returned. |
| `direction` | string ("ASC" | "DESC") | No | Sorting direction ('ASC' or 'DESC'). |
| `includeDrafts` | boolean | No | If true, includes draft events. |
| `includeDeleted` | boolean | No | If true, includes deleted events. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Import Contacts

**Slug:** `EVENIUM_IMPORT_CONTACTS`

Tool to import multiple contacts at once (batch import). Creates new contacts or updates existing ones based on customId or email matching. Use when you need to bulk create or update contacts in Evenium.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contacts` | array | Yes | Array of contact objects to import. Each contact will be created if new or updated if it already exists (matched by customId or email). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Logout

**Slug:** `EVENIUM_LOGOUT`

Tool to log out the current user and invalidate the session token. Use when you need to explicitly end the current session.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact

**Slug:** `EVENIUM_UPDATE_CONTACT`

Tool to update an existing contact in Evenium by contact ID. Use when you need to modify contact details such as email, name, company, or custom fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Updated email address for the contact |
| `phone` | string | No | Updated phone number |
| `state` | string | No | Updated state or region |
| `fields` | array | No | List of custom fields to update with their values |
| `company` | string | No | Updated company name |
| `country` | string | No | Updated country |
| `lastName` | string | No | Updated last name |
| `contactId` | string | Yes | Unique identifier of the contact to update |
| `firstName` | string | No | Updated first name |
| `organization` | string | No | Updated organization name |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact by Custom ID

**Slug:** `EVENIUM_UPDATE_CONTACT_BY_CUSTOM_ID`

Tool to update a contact in Evenium by custom ID (external ID from your CRM/database). Use when you need to update contact details using your own identifier rather than Evenium's internal ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Contact's email address. |
| `fields` | array | No | Custom fields array with name-value pairs. |
| `company` | string | No | Company name. |
| `customId` | string | Yes | Custom ID (external ID from your CRM/database). This will be used with the ext: prefix in the URL path. |
| `lastName` | string | No | Contact's last name. |
| `firstName` | string | No | Contact's first name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |