NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Evenium connects to a Nagent workspace with an API key. Once it is connected, agents can call 12 Evenium actions, such as "Create Contact", "Get Contact" and "Get Contact by Custom ID". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Evenium, with input parameters and output schema.
EVENIUM_CREATE_CONTACTTool 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
Contact's email address. Should be a valid email format.
Array of custom fields with name/value pairs for additional contact information.
Gender options for contact.
Name of the company the contact is associated with.
External or custom contact ID for integration purposes.
Contact's last name.
Contact's first name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_DELETE_CONTACTTool 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
Unique identifier of the contact to delete. WARNING: This operation is irreversible and will delete all associated guests in cascade.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_GET_CONTACTTool 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
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_GET_CONTACT_BY_CUSTOM_IDTool 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
Custom ID specific to your database or CRM system. This is an external identifier you use to reference contacts in your own system.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_GET_CONTACT_EVENTSTool 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
Contact ID to retrieve events for.
Filter events with endDate after this timestamp (RFC 3339 format).
Filter events with endDate before this timestamp (RFC 3339 format).
Filter events with startDate after this timestamp (RFC 3339 format).
Filter events with creationDate after this timestamp (RFC 3339 format).
Filter events with startDate before this timestamp (RFC 3339 format).
Filter events with creationDate before this timestamp (RFC 3339 format).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_GET_CONTACT_EVENTS_BY_CUSTOM_IDRetrieves 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
Custom ID specific to your database used to identify the contact.
Filter events ending after this date (ISO 8601 format or date string).
Filter events ending before this date (ISO 8601 format or date string).
Filter events starting after this date (ISO 8601 format or date string).
Filter events created after this date (ISO 8601 format or date string).
Filter events starting before this date (ISO 8601 format or date string).
Filter events created before this date (ISO 8601 format or date string).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_GET_CONTACTSTool to retrieve a list of contacts from Evenium. Use when you need to fetch and optionally filter organizer contacts.
Input parameters
Page number for pagination (1-indexed). Defaults to 1.
Field name to sort results by (e.g., 'lastName', 'firstName', 'email').
Search term to filter contacts by name, email, or other fields.
Number of contacts to return per page. Defaults to 10.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_GET_EVENTSRetrieves 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
Field to sort results by. Common options: 'beginDate' (event start date), 'title' (event name), 'code' (event code).
Maximum number of events to retrieve.
Zero-based index of the first event to retrieve for pagination.
Search term to filter events by title, code, or location.
If true, only archived events are returned.
Sorting direction ('ASC' or 'DESC').
If true, includes draft events.
If true, includes deleted events.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_IMPORT_CONTACTSTool 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
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_LOGOUTTool to log out the current user and invalidate the session token. Use when you need to explicitly end the current session.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_UPDATE_CONTACTTool 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
Updated email address for the contact
Updated phone number
Updated state or region
List of custom fields to update with their values
Updated company name
Updated country
Updated last name
Unique identifier of the contact to update
Updated first name
Updated organization name
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EVENIUM_UPDATE_CONTACT_BY_CUSTOM_IDTool 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
Contact's email address.
Custom fields array with name-value pairs.
Company name.
Custom ID (external ID from your CRM/database). This will be used with the ext: prefix in the URL path.
Contact's last name.
Contact's first name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 12 Evenium actions on Nagent, including "Create Contact", "Get Contact" and "Get Contact by Custom ID". Create Contact: Create a new contact in the Evenium address book. Each action is listed on this page with its input parameters and its output.
Evenium connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 7 optional inputs: email, fields, gender, company, customId, lastName and firstName. It returns data, error and successful.