# Connect V3 Documentation

> Documentation for Connect V3

## API Reference
- [Authenticate a backoffice user](https://docs-connect-api-v3.eventtia.com/reference/authenticateuser.md): Logs in a backoffice user with email and password. Returns a JWT auth_token used as a Bearer token for subsequent API calls. If the user's password has expired, returns 429 with an expiration message.
- [Machine-to-machine authentication](https://docs-connect-api-v3.eventtia.com/reference/authenticatem2m.md): Authenticates a machine-to-machine (M2M) OAuth client using client_id and client_secret. Returns an access_token (JWT), scope, expiration, and token_type. Used for backend integrations that do not involve a human user.
- [List users for the current account](https://docs-connect-api-v3.eventtia.com/reference/listusers.md): Returns a paginated list of users belonging to the authenticated user's account (archived users are excluded). Requires the `view_users` permission; admin users bypass the permission check.
- [Create a user](https://docs-connect-api-v3.eventtia.com/reference/createuser.md): Creates a new user in the authenticated user's account. Requires the `create_users` permission. The request body must use JSON:API format. Validations enforce: name presence, valid email format, password complexity, and a numeric default_role_id.
- [Get current user permissions](https://docs-connect-api-v3.eventtia.com/reference/getuserpermissions.md): Returns the authenticated user's admin status and permission keys. Admin users receive `is_admin: true` with an empty permissions array (admins bypass all permission checks). Non-admin users receive the permission keys from their assigned role. Cached for 10 minutes.
- [Get a single user](https://docs-connect-api-v3.eventtia.com/reference/getuser.md): Returns details of a single user by ID. The user must belong to the same account as the authenticated user. Requires the `view_users` permission. Returns 403 if the user is not found within the current account.
- [Update a user](https://docs-connect-api-v3.eventtia.com/reference/updateuser.md): Updates an existing user's attributes. The user must belong to the same account as the authenticated user. Requires the `edit_users` permission. The request body must use JSON:API format. Only provided attributes are updated.
- [Archive a user](https://docs-connect-api-v3.eventtia.com/reference/destroyuser.md): Archives a user (soft delete). The user is deactivated and their email is cleared. Associated permissions are also removed. Requires the `delete_users` permission.
- [List roles for the current account](https://docs-connect-api-v3.eventtia.com/reference/listroles.md): Returns a paginated list of roles belonging to the authenticated user's account. Requires the `view_roles` permission. Roles define permission sets that can be assigned to users via the `default_role_id` field.
- [List administrative areas for the account](https://docs-connect-api-v3.eventtia.com/reference/listentities.md): Returns a paginated list of administrative areas (entities) accessible to the authenticated user. Admin users and users with access to all events see every area in the account. Other users see only the areas assigned to them. Administrative areas are used to organize and restrict event access by region or organizational unit.
- [List all webhooks for the authenticated user's account](https://docs-connect-api-v3.eventtia.com/reference/listaccountwebhooks.md): Returns a paginated list of all API-created webhooks for the authenticated user's account. Includes both account-scoped and event-scoped webhooks. Default page size is 24.
- [Create an account-level webhook](https://docs-connect-api-v3.eventtia.com/reference/createaccountwebhook.md): Creates a new webhook at the account level. Account-level webhooks fire for the specified trigger across all events in the account. The webhook URL must be a valid HTTP(S) URL and must be unique per trigger within the same account.  Optionally, for `attendee_created` and `attendee_updated` triggers, you can pass `administrative_area_ids` to restrict the webhook to only fire when the attendee's event belongs to one of the specified administrative areas. The IDs must reference non-archived administrative areas in the same account.
- [Delete an account-level webhook](https://docs-connect-api-v3.eventtia.com/reference/destroyaccountwebhook.md): Deletes an existing account-level webhook. The webhook is identified by its target_url and trigger combination (passed as query parameters). Both must match an existing webhook for the account.
- [List webhooks for a specific event](https://docs-connect-api-v3.eventtia.com/reference/listeventwebhooks.md): Returns a paginated list of API-created webhooks scoped to a specific event. Only webhooks associated with the given event are returned. Default page size is 24.
- [Create an event-level webhook](https://docs-connect-api-v3.eventtia.com/reference/createeventwebhook.md): Creates a new webhook scoped to a specific event. Event-level webhooks fire only for the specified trigger within this event. The webhook URL must be a valid HTTP(S) URL and must be unique per trigger within the same event. Requires the event to have webhooks enabled; returns an error if webhooks are disabled.  Note: `administrative_area_ids` conditions are not supported for event-level webhooks. Use account-level webhooks to apply administrative area filtering.
- [Delete an event-level webhook](https://docs-connect-api-v3.eventtia.com/reference/destroyeventwebhook.md): Deletes an existing event-level webhook. The webhook is identified by its target_url and trigger combination (passed as query parameters). The target URL and trigger must match an existing webhook for the event. Requires the event to have webhooks enabled.
- [List events](https://docs-connect-api-v3.eventtia.com/reference/listevents.md): Returns a paginated list of events accessible by the authenticated user. Events are scoped to the user's account and filtered by the user's event-level permissions. Supports sorting via the `order` parameter and incremental sync via `updated_since`. Default sort is start_date desc.
- [Create an event](https://docs-connect-api-v3.eventtia.com/reference/createevent.md): Creates a new event under the authenticated user's account. The event is automatically provisioned with mailing defaults, default zones, file categories, attendee types, app settings, and stand profile fields. Returns the created event with its API key in the meta object.
- [Get a single event](https://docs-connect-api-v3.eventtia.com/reference/getevent.md): Returns a single event by its slug (event_uri) or numeric ID. Publicly accessible without authentication. When a valid JWT token is provided, the response includes additional fields: budget, total_attendees, total_speakers, total_workshops, country_id, api_key, uuid, and full custom fields. Response is cached for 5 minutes.
- [Update an event](https://docs-connect-api-v3.eventtia.com/reference/updateevent.md): Updates an existing event. Only the provided attributes will be changed. The event must belong to the authenticated user's account. The updated event resource is returned on success.
- [Get ticket statistics](https://docs-connect-api-v3.eventtia.com/reference/getticketstats.md): Alias for the attendee-type-stats endpoint. Returns the same per-ticket-type seat usage data. Both /attendee-type-stats and /tickets-stats return identical results.
- [Get workshops statistics](https://docs-connect-api-v3.eventtia.com/reference/getworkshopsstats.md): Returns the top 5 most-attended active workshops for the event, ranked by checked-in attendee count. Each workshop includes a checked_in field with the number of attendees who checked in. Response is cached for 5 minutes.
- [List events for an account calendar (public)](https://docs-connect-api-v3.eventtia.com/reference/listeventsbyaccountuuid.md): Public endpoint that returns a paginated list of active, non-archived events for a given account, identified by the account's UUID. Results include dates with timezone offset, logo/banner images, and public custom fields. Supports date range filters and keyword search. Cached for 10 minutes.
- [List account-level event custom fields](https://docs-connect-api-v3.eventtia.com/reference/listaccountcustomfields.md): Returns a paginated list of event custom fields belonging to the authenticated user's account. Supports an optional `filterable` query parameter to return only filterable fields. Cached for 60 minutes.
- [Get an event parameter by name](https://docs-connect-api-v3.eventtia.com/reference/geteventparam.md): Returns a single event parameter identified by its symbolic name. Event parameters are key-value configuration entries for an event (e.g. tracking codes, custom aliases, payment configuration). Requires user authentication.
- [Update an event parameter](https://docs-connect-api-v3.eventtia.com/reference/updateeventparam.md): Creates or updates an event parameter by its symbolic name. Only whitelisted parameter names can be updated via this endpoint (currently: `aux_json_data`). Returns 403 if the param_name is not in the whitelist. Requires user authentication.
- [List attendees for an event](https://docs-connect-api-v3.eventtia.com/reference/listattendees.md): Returns a paginated list of attendees for the given event. Supports filtering by attendee type, check-in status, keyword search, and custom field values. Cached for 30 minutes. User-authenticated requests return full attendee data; attendee-authenticated requests require the event's app_settings to allow listing.
- [Get a single attendee](https://docs-connect-api-v3.eventtia.com/reference/getattendee.md): Returns a single attendee by ID or UUID. Includes ticket type, business conference participants, and related data by default when the requester is the attendee themselves. User-authenticated requests can view any attendee in the event; attendee-authenticated requests are restricted to their own record unless the event's app_settings allows listing.
- [Update an attendee](https://docs-connect-api-v3.eventtia.com/reference/updateattendee.md): Updates an existing attendee's profile fields. Supports updating standard fields (first_name, last_name, etc.) and custom field values. User-authenticated requests can update any attendee; attendee-authenticated requests can only update their own record (or via sponsor delegation).
- [Archive (soft-delete) an attendee](https://docs-connect-api-v3.eventtia.com/reference/deleteattendee.md): Archives (soft-deletes) the specified attendee. The attendee record is not physically deleted but marked as archived. Attendee-authenticated requests require sponsor delegation permissions.
- [Check in an attendee](https://docs-connect-api-v3.eventtia.com/reference/checkinattendee.md): Marks the attendee as checked in to the event. Validates that the attendee has paid (or the attendee type allows unpaid check-in), is in confirmed status, and has not already been checked in. Returns the updated attendee with seat allocation info if applicable.
- [Cancel an attendee registration](https://docs-connect-api-v3.eventtia.com/reference/cancelattendee.md): Cancels the attendee's registration for the event. Returns 200 on success or 422 if the cancellation fails.
- [Mark an attendee for badge printing](https://docs-connect-api-v3.eventtia.com/reference/printattendee.md): Marks the attendee for badge printing. Requires the print_attendees permission. The attendee must have paid (or the attendee type must allow printing without payment). Returns a confirmation message.
- [Batch check-in multiple attendees](https://docs-connect-api-v3.eventtia.com/reference/batchcheckinattendees.md): Submits batch check-in operations for multiple attendees. Each check-in is processed asynchronously in the background. Designed for offline sync from the Eventtia Check-In app.
- [Find an attendee by email](https://docs-connect-api-v3.eventtia.com/reference/getattendeebyemail.md): Looks up a single confirmed attendee by email address within the event. Cached for 5 minutes. Returns the attendee data if found, null data otherwise.
- [Update attendee workshop registrations](https://docs-connect-api-v3.eventtia.com/reference/updateattendeeactivities.md): Replaces the attendee's workshop registrations with the provided set of workshop IDs. Recalculates payments after updating. Returns the attendee with ticket type and business conference data.
- [Register a new attendee](https://docs-connect-api-v3.eventtia.com/reference/registerattendee.md): Registers a new attendee for the event. Validates submitted fields against the chosen ticket type's custom field definitions, processes workshop enrollment, purchase items, coupon codes, and payment initialization.  **Group registration:** When the attendee's ticket type is configured with allowed invitee types, registering that attendee automatically creates a new group with them as leader. The response `meta` object then contains `group_uuid` and a `profiles` map describing which invitee types have seats available. Additional attendees can join this group by passing `group_registration_uuid` (the `group_uuid` value) in their own registration request -- their `attendee_type_id` must match one of the allowed invitee types with available seats.  Supports both user and attendee (sponsor-delegated) authentication.
- [List attendee types for an event](https://docs-connect-api-v3.eventtia.com/reference/listattendeetypes.md): Returns a paginated list of ticket types for the event, ordered by ID ascending. Each type includes capacity, availability, pricing, and custom field definitions. Public endpoint -- authentication is optional.
- [Get attendee event check-in status](https://docs-connect-api-v3.eventtia.com/reference/getattendeeeventcheckin.md): Returns the event-level check-in status of a specific attendee. Indicates whether the attendee has checked in to the event and, if so, the check-in timestamp converted to the event's local timezone. Designed for sync apps and check-in kiosks that need to verify whether an individual attendee is already checked in.
- [List attendee checkpoint check-ins](https://docs-connect-api-v3.eventtia.com/reference/listattendeecheckpointcheckins.md): Returns a paginated list of checkpoint check-in logs for a specific attendee. Each log records an entry (and optional exit) at a named checkpoint within the event. Includes the checkpoint name, entry timestamp, and checkout status. Logs are ordered by creation time descending (most recent first).
- [List attendee workshop check-ins](https://docs-connect-api-v3.eventtia.com/reference/listattendeeworkshopcheckins.md): Returns a paginated list of workshop check-ins for a specific attendee. Only includes workshops where the attendee has an active registration and has physically checked in (checked_in = true). Results are ordered by check-in date descending (most recent first).
- [List guests for an event](https://docs-connect-api-v3.eventtia.com/reference/listguests.md): Returns a paginated list of guests for the event. Supports sorting by `full_name` or any guest column. Includes optional sideloaded relationships (`attendee`, `attendee_type`).
- [Create a guest](https://docs-connect-api-v3.eventtia.com/reference/createguest.md): Creates a new guest for the specified event, associated with the authenticated user.
- [Get a single guest](https://docs-connect-api-v3.eventtia.com/reference/getguest.md): Returns a single guest by ID. Supports optional sideloaded relationships (`attendee`, `attendee_type`) via the `include` query parameter.
- [List purchase items for an event](https://docs-connect-api-v3.eventtia.com/reference/listpurchaseitems.md): Returns a paginated list of non-archived purchase items (add-ons) available for the given event. Each item includes pricing by attendee type, stock quantities, and image URLs. Results are cached for 2 minutes. No authentication required.
- [Get a single purchase item](https://docs-connect-api-v3.eventtia.com/reference/getpurchaseitem.md): Returns a single non-archived purchase item by ID for the given event. Includes pricing by attendee type, stock quantities, and image URLs. Results are cached for 2 minutes. No authentication required.
- [List all attendee purchase items for an event](https://docs-connect-api-v3.eventtia.com/reference/listattendeepurchaseitems.md): Returns a paginated list of all attendee purchase item records across the event. Each record represents a specific attendee's purchase of a specific item, including quantity and paid status. Supports optional relationship includes (attendee, purchase_item).
- [List purchase items for a specific attendee](https://docs-connect-api-v3.eventtia.com/reference/listattendeepurchaseitemsbyattendee.md): Returns a paginated list of purchase item records for a specific attendee. Each record includes the quantity purchased and payment status. Supports optional relationship includes (attendee, purchase_item).
- [Validate a coupon code](https://docs-connect-api-v3.eventtia.com/reference/validatecouponcode.md): Validates a coupon code against a specific attendee type for the given event. Returns the coupon's discount details (amount or percentage), whether it is valid for the specified attendee type, and its current usage count vs limit. Returns 404 if the coupon code or attendee type is not found.
- [Get coupon code details](https://docs-connect-api-v3.eventtia.com/reference/getcouponcode.md): Returns the details of a single coupon code scoped to the given event. The coupon must belong to the event — passing a valid coupon ID from a different event returns 404. Requires a User JWT token.
- [List workshops for an event](https://docs-connect-api-v3.eventtia.com/reference/listworkshops.md): Returns a paginated list of workshops for the given event. Supports filtering by name, category, attendee type, sponsor, attendance mode, date, speakers, and workshop definition. When called with an attendee token, results may be filtered by app settings. Responses are cached for 5 minutes for public (unauthenticated) requests.
- [Create a workshop](https://docs-connect-api-v3.eventtia.com/reference/createworkshop.md): Creates a new workshop (session) for the specified event. Automatically creates or assigns a workshop definition for the new session. Requires user or attendee (sponsor) authentication.
- [Get a single workshop](https://docs-connect-api-v3.eventtia.com/reference/getworkshop.md): Returns a single workshop by ID. Supports optional relationship includes (speakers, workshop_categories). Response includes workshop details such as availability, streaming configuration, and checked attendees count.
- [Update a workshop](https://docs-connect-api-v3.eventtia.com/reference/updateworkshop.md): Updates an existing workshop. Supports updating name, description, dates, availability, location, streaming settings, speaker_ids, and workshop_category_ids. Associated speaker and category assignments are also updated. Requires user or attendee (sponsor) authentication.
- [Delete a workshop](https://docs-connect-api-v3.eventtia.com/reference/deleteworkshop.md): Deletes a workshop (soft delete). The workshop is marked as archived and no longer appears in listings. Returns 422 if the workshop is the last session in a workshop definition when workshop slots are enabled. Requires user or attendee (sponsor) authentication.
- [Get booking info for a workshop](https://docs-connect-api-v3.eventtia.com/reference/getworkshopbookinginfo.md): Returns booking information for a specific workshop, including name, availability, used seats, and start/end dates with event timezone offset.
- [List check-ins for a workshop](https://docs-connect-api-v3.eventtia.com/reference/listworkshopcheckins.md): Returns the list of checked-in attendees for the specified workshop. Each record includes the attendee's check-in date and status. Responses are cached for 5 minutes.
- [Set categories for a workshop](https://docs-connect-api-v3.eventtia.com/reference/setworkshopcategories.md): Assigns workshop categories to the specified workshop. Pass category IDs as a comma-separated string. Replaces any previously assigned categories. Requires user or attendee (sponsor) authentication.
- [List available days with workshops](https://docs-connect-api-v3.eventtia.com/reference/listavailabledays.md): Returns an array of unique dates that have workshops available for registration. Only workshops visible in registration, with available seats, and in the future are included. Supports filtering by speaker, category, name, date, and attendee type. Responses are cached for 10 minutes.
- [List available workshop slots](https://docs-connect-api-v3.eventtia.com/reference/listavailableslots.md): Returns a paginated list of available workshop time slots for registration. Each slot includes start/end times, location, price, availability, total registered count, and blocking workshop information. Only workshops visible in registration, with available seats, and in the future are returned. Responses are cached for 60 seconds.
- [Batch check-in attendees to workshops](https://docs-connect-api-v3.eventtia.com/reference/batchcheckinworkshops.md): Queues check-in operations for multiple attendees across workshops. Each entry specifies an attendee UUID, workshop ID, and check-in date. Operations run in the background -- the response returns immediately. Requires user authentication.
- [List booking info for all workshops](https://docs-connect-api-v3.eventtia.com/reference/listworkshopbookinginfo.md): Returns booking information for all workshops in the event, including name, availability, used seats, and start/end dates. Responses are cached for 2 seconds.
- [Export workshops to Excel](https://docs-connect-api-v3.eventtia.com/reference/exportworkshops.md): Starts an Excel export of workshops for the event. The export runs in the background -- returns an export process record that can be polled for progress and download URL. Requires user authentication with view_workshops permission.
- [List workshops for an attendee](https://docs-connect-api-v3.eventtia.com/reference/listattendeeworkshops.md): Returns the list of workshops that the specified attendee is registered for. Results are ordered by start_date ascending, then workshop name ascending. Requires user or attendee authentication.
- [List workshop definitions](https://docs-connect-api-v3.eventtia.com/reference/listworkshopdefinitions.md): Returns a paginated list of workshop definitions for the event. Workshop definitions group multiple sessions under a common name, description, and configuration. Publicly accessible.
- [Create a workshop definition](https://docs-connect-api-v3.eventtia.com/reference/createworkshopdefinition.md): Creates a new workshop definition for the event. Workshop definitions group multiple sessions under a shared name and configuration. Supports localized name and description (en, es, fr, pt, de). Requires at least one session (workshops_attributes). Requires user authentication with create_workshops permission.
- [Get a single workshop definition](https://docs-connect-api-v3.eventtia.com/reference/getworkshopdefinition.md): Returns a single workshop definition by ID. Workshop definitions contain localized name/description, session dates, and attendee type visibility settings.
- [Update a workshop definition](https://docs-connect-api-v3.eventtia.com/reference/updateworkshopdefinition.md): Updates an existing workshop definition. Supports updating localized name, description, and other configuration. Requires user authentication with edit_workshops permission.
- [Delete a workshop definition](https://docs-connect-api-v3.eventtia.com/reference/deleteworkshopdefinition.md): Archives a workshop definition (soft delete). Requires user authentication with delete_workshops permission.
- [List sessions for a workshop definition](https://docs-connect-api-v3.eventtia.com/reference/listworkshopdefinitionsessions.md): Returns a paginated list of workshop sessions (workshops) belonging to the specified workshop definition. Each session represents a specific time slot of the definition. Requires user authentication.
- [List workshop categories](https://docs-connect-api-v3.eventtia.com/reference/listworkshopcategories.md): Returns a paginated list of workshop categories for the event. Responses are cached for 5 minutes.
- [List speakers for an event](https://docs-connect-api-v3.eventtia.com/reference/listspeakers.md): Returns a paginated list of speakers for the event. Supports optional relationship includes (workshops, workshop_categories). Responses are cached for 2 minutes.
- [Get a single speaker](https://docs-connect-api-v3.eventtia.com/reference/getspeaker.md): Returns a single speaker by ID. Automatically includes workshops and workshop categories relationships in the response. Responses are cached for 2 minutes. Returns null if speaker not found.
- [List attendee workshop registrations](https://docs-connect-api-v3.eventtia.com/reference/listattendeeworkshopregistrations.md): Returns the list of workshop registrations for the authenticated attendee, showing which workshops they are registered for and their check-in status.
- [Register attendee for a workshop](https://docs-connect-api-v3.eventtia.com/reference/createattendeeworkshop.md): Registers the authenticated attendee for a workshop. If applicable, payment totals are recalculated. Returns the registration record with meta containing the attendee's current workshop IDs.
- [Unregister attendee from a workshop](https://docs-connect-api-v3.eventtia.com/reference/deleteattendeeworkshop.md): Removes the attendee's registration from a workshop. If applicable, payment totals are recalculated. Returns the deleted record with meta containing the attendee's remaining workshop IDs.
- [Check in attendee to a workshop](https://docs-connect-api-v3.eventtia.com/reference/checkinattendeeworkshop.md): Checks in the authenticated attendee to a workshop. The attendee must have confirmed status. Returns 422 if the attendee is not confirmed. On success, returns the attendee record with custom_messages meta.
- [List attendees for a workshop](https://docs-connect-api-v3.eventtia.com/reference/listworkshopattendees.md): Returns a paginated list of attendees registered for the specified workshop. Requires user or attendee authentication.
- [List participant types for a business conference](https://docs-connect-api-v3.eventtia.com/reference/listparticipanttypes.md): Returns a paginated list of active participant types for the specified business conference. Each type defines the role and configuration for a category of networking participants, including agenda settings, profile fields, meeting request permissions, and linked attendee types. Public endpoint -- no authentication required. Cached for 5 minutes.
- [List unavailable hours for a participant type](https://docs-connect-api-v3.eventtia.com/reference/listunavailablehours.md): Returns a paginated list of unavailable time windows for the specified participant type. Unavailable hours define periods when participants of this type cannot be scheduled for meetings. Requires user authentication. Cached for 5 minutes.
- [Create an unavailable hour for a participant type](https://docs-connect-api-v3.eventtia.com/reference/createunavailablehour.md): Creates an unavailable time window for the specified participant type. Dates must fall within the participant type's agenda range, start must precede end, and the window must not overlap with existing accepted meetings. Requires user authentication.
- [Update an unavailable hour](https://docs-connect-api-v3.eventtia.com/reference/updateunavailablehour.md): Updates an existing unavailable time window for the specified participant type. Same validations as creation: dates must fall within the agenda range and must not overlap with existing meetings. Requires user authentication.
- [Delete an unavailable hour](https://docs-connect-api-v3.eventtia.com/reference/deleteunavailablehour.md): Deletes an unavailable time window for the specified participant type, re-opening that period for meeting scheduling. Requires user authentication.
- [List ratings by the current participant](https://docs-connect-api-v3.eventtia.com/reference/listratings.md): Returns a paginated list of ratings submitted by the current participant. Each rating represents a preference score (1-5) assigned to another participant as a potential meeting partner. Ratings are used by the automatic scheduling algorithm to optimize meeting assignments. Requires attendee or app authentication.
- [Create or update a rating for a participant](https://docs-connect-api-v3.eventtia.com/reference/updaterating.md): Creates or updates the current participant's rating for the target participant. Ratings express meeting preference on a scale of 1-5 and feed into the automatic scheduling algorithm. Both participants must belong to the same conference with permitted types, and the booking deadline must not have passed. Requires attendee or app authentication.
- [Remove a rating for a participant](https://docs-connect-api-v3.eventtia.com/reference/deleterating.md): Removes the current participant's rating for the target participant. The target will no longer appear in the rater's preference list for automatic scheduling. Requires attendee or app authentication.
- [Update the duration of a meeting](https://docs-connect-api-v3.eventtia.com/reference/updatemeetingduration.md): Records or updates the elapsed meeting duration (in seconds) for the current participant. The value is persisted after 30 minutes of inactivity. Used for tracking real-time meeting time during live networking events. Requires attendee authentication.
- [List meeting requests](https://docs-connect-api-v3.eventtia.com/reference/listmeetingrequests.md): Returns a paginated list of meeting requests for the current participant. Filter by status, direction (sent_by_me / received_by_me), and slot_id. Supports including related resources: sent_by, received_by, and slot. Requires attendee authentication.
- [Create a meeting request](https://docs-connect-api-v3.eventtia.com/reference/createmeetingrequest.md): Sends a meeting request from the current participant to another participant for a specific time slot. The slot must be available for both parties, neither party may exceed the requests-per-slot limit, no duplicate request or existing meeting may exist, and the booking deadline must not have passed. On success, an email notification is sent to the recipient. Requires attendee authentication.
- [Cancel a meeting request](https://docs-connect-api-v3.eventtia.com/reference/deletemeetingrequest.md): Cancels an existing meeting request. Only the sender or the receiver can cancel, and already-rejected requests cannot be cancelled again. On success, a notification is sent to the other party. Requires attendee authentication.
- [Approve a meeting request](https://docs-connect-api-v3.eventtia.com/reference/approvemeetingrequest.md): Approves a pending meeting request, creating an actual meeting between the sender and receiver for the requested time slot. Only the receiver can approve. On approval, conflicting requests for the same slot are automatically rejected. Requires attendee authentication (must be the request receiver).
- [Create or update a note for a meeting](https://docs-connect-api-v3.eventtia.com/reference/updatemeetingnote.md): Creates or updates a note on a specific meeting by the current participant. Each participant can have one note per meeting. Only participants involved in the meeting (host or guest) can create notes. Requires attendee authentication.
- [List business conferences for an event](https://docs-connect-api-v3.eventtia.com/reference/listbusinessconferences.md): Returns a paginated list of business conferences for the given event. With an app token, results are scoped to conferences accessible by that app. With a user token, all conferences are returned. Supports filtering by updated_since timestamp. Includes participant types and their profile fields by default. Cached for 5 minutes.
- [List meetings for a business conference](https://docs-connect-api-v3.eventtia.com/reference/listbusinessconferencemeetings.md): Returns a paginated list of meetings for the specified business conference. Includes host and participant data. Supports filtering by meeting_ids. With a user token, all fields are included. Cached for 2 minutes.
- [Create a new meeting request](https://docs-connect-api-v3.eventtia.com/reference/createbusinessconferencemeeting.md): Creates a meeting between the authenticated attendee and another participant for a specific time slot. Both participants must be available at the requested time. Returns 400 if the slot is unavailable, the meeting is a duplicate, it is a self-request, or permission is denied between participant types.
- [Get a meeting by ID](https://docs-connect-api-v3.eventtia.com/reference/getbusinessconferencemeetingbyid.md): Returns a single business conference meeting by its numeric ID. The authenticated attendee must be a participant in this meeting. For online conferences, metadata includes a next_meeting field with the participant's next confirmed meeting. Supports offset_to_utc to convert dates to UTC.
- [Update a meeting by ID (accept or reject)](https://docs-connect-api-v3.eventtia.com/reference/updatebusinessconferencemeetingbyid.md): Updates the status of a meeting identified by numeric ID. Set status to 2 (accepted) to confirm, or 3 (rejected) to cancel. An optional rejection_reason can be provided when rejecting. Returns 400 if the status transition is invalid.
- [Get a meeting by GUID](https://docs-connect-api-v3.eventtia.com/reference/getbusinessconferencemeetingbyguid.md): Returns a single business conference meeting by its GUID. Useful for external integrations and public-facing links where exposing the numeric ID is undesirable. The authenticated attendee must be a participant in this meeting.
- [Update a meeting by GUID (accept or reject)](https://docs-connect-api-v3.eventtia.com/reference/updatebusinessconferencemeetingbyguid.md): Updates the status of a meeting identified by its GUID. Set status to 2 (accepted) to confirm, or 3 (rejected) to cancel.
- [Change attendance mode for a meeting](https://docs-connect-api-v3.eventtia.com/reference/changeattendancemode.md): Changes the attendance mode (e.g. in-person, virtual) for the authenticated attendee in a meeting. The attendee must be a participant in this meeting.
- [Download ICS calendar file for a meeting](https://docs-connect-api-v3.eventtia.com/reference/getmeetingics.md): Generates and returns an ICS (iCalendar) file for the specified meeting. The authenticated attendee must be a participant in this meeting. Includes meeting time, location, and participant details. Cached for 2 minutes.
- [Get the meeting agenda for a participant](https://docs-connect-api-v3.eventtia.com/reference/getparticipantagenda.md): Returns the full meeting agenda for a specific participant. Includes all requested and accepted meetings. Metadata contains available time slots, blocked slots, and meeting status constants. Supports user, app, and attendee authentication.
- [List participants in a business conference](https://docs-connect-api-v3.eventtia.com/reference/listbusinessconferenceparticipants.md): Returns a paginated list of participants in the specified business conference. With an attendee token, the current participant is excluded and results may be filtered by participant type permissions and confirmation status. With a user or app token, all participants are returned. Supports updated_since filtering and include_count for participant totals in metadata. Cached for 30 minutes.
- [Get a single participant](https://docs-connect-api-v3.eventtia.com/reference/getbusinessconferenceparticipant.md): Returns details of a single participant in a business conference. Includes participant type, profile fields, and attendee custom fields. With an app token, blocked_slots include additional unavailable hours. Cached for 10 minutes for public and attendee requests.
- [Update participant public profile](https://docs-connect-api-v3.eventtia.com/reference/updatebusinessconferenceparticipant.md): Updates the public profile of the authenticated attendee's participant record. Attendees can only update their own profile. Accepts profile_display_name, profile_contact_name, profile_contact_email, and custom profile fields. Returns 400 if required profile fields are missing.
- [List available participants for a time slot](https://docs-connect-api-v3.eventtia.com/reference/listavailableparticipants.md): Returns a list of participant IDs available to meet with the specified participant during the given time slot. The authenticated attendee must be a participant in this conference.
- [List blacklisted participants](https://docs-connect-api-v3.eventtia.com/reference/listblacklistedparticipants.md): Returns a paginated list of participants that the current participant has blacklisted. Blacklisted participants cannot exchange meeting requests with the current participant. Requires attendee or app authentication.
- [Blacklist a participant](https://docs-connect-api-v3.eventtia.com/reference/createparticipantblacklist.md): Adds the specified participant to the current participant's blacklist, preventing meeting requests between them. If the participant was previously unblacklisted, the existing record is reactivated. The conference must have blacklisting enabled and the participant type must have available blacklist slots. Returns 400 if the blacklist limit is exceeded or blacklisting is disabled.
- [Remove a participant from blacklist](https://docs-connect-api-v3.eventtia.com/reference/deleteparticipantblacklist.md): Removes the specified participant from the current participant's blacklist, re-allowing meeting requests between them. If no blacklist record exists, the request succeeds silently (idempotent).
- [List surveys for an event](https://docs-connect-api-v3.eventtia.com/reference/listsurveys.md): Returns a paginated list of surveys for the given event. When called with an attendee token the list is filtered to enabled surveys whose target attendee types include the authenticated attendee, ordered by name. When called without authentication (public) or with a user token, all non-archived surveys for the event are returned ordered by name. Response is HTTP-cached for 5 seconds.
- [Get a single survey](https://docs-connect-api-v3.eventtia.com/reference/getsurvey.md): Returns a single survey by ID. The authenticated attendee must belong to one of the survey's targeted attendee types. Includes the `answered` flag indicating whether the current attendee has already submitted answers. Response is cached for 10 minutes.
- [Submit answers for a survey](https://docs-connect-api-v3.eventtia.com/reference/submitsurveyanswers.md): Submits answers for a survey on behalf of the authenticated attendee. The `answers` parameter must be a JSON-encoded string containing a hash that maps custom field IDs to answer values. Works for both quiz-type and regular attendee surveys. Returns 400 if answer validations fail (e.g. required field missing, already answered).
- [List answers for a survey](https://docs-connect-api-v3.eventtia.com/reference/listsurveyanswers.md): Returns a paginated list of all non-archived answers submitted for the specified survey. Each answer contains the respondent reference (entity_id/entity_type) and a values hash mapping custom field IDs to submitted values. Requires user authentication.
- [List Q&A sessions for an event](https://docs-connect-api-v3.eventtia.com/reference/listeventqasessions.md): Returns a paginated list of non-archived, non-draft Q&A sessions for the event. When called with an attendee token, results are filtered to enabled sessions whose attendee_type_ids include the authenticated attendee's type. When called without authentication (public), all published sessions are returned.
- [List questions for a Q&A session](https://docs-connect-api-v3.eventtia.com/reference/listeventqasessionquestions.md): Returns a paginated list of non-archived questions for the specified Q&A session, ordered by creation date descending (newest first). Supports filtering by status (comma-separated: approved, rejected, pending, answered) and sorting by `liked_by` count via the `order` parameter. Response is HTTP-cached for 15 seconds.
- [Create a question in a Q&A session](https://docs-connect-api-v3.eventtia.com/reference/createeventqasessionquestion.md): Submits a new question to the specified Q&A session on behalf of the authenticated attendee. The attendee's attendee type must be included in the session's allowed types. Rate-limited: an attendee can only submit one question per session. If the session is moderated, the question is created with 'pending' status and the response body is empty (null data) until approved. If anonymous_questions is enabled on the session and the request sets anonymous_question to true, the attendee identity is not stored.
- [Toggle like on a Q&A session question](https://docs-connect-api-v3.eventtia.com/reference/togglelikeeventqasessionquestion.md): Toggles a like on the specified Q&A session question for the authenticated attendee. If the attendee has already liked the question, the like is removed; otherwise it is added. The attendee's attendee type must be included in the session's allowed types. Returns the updated question with the modified liked_by array.
- [List sponsors](https://docs-connect-api-v3.eventtia.com/reference/listsponsors.md): Returns a paginated list of sponsors for the given event, ordered by amount descending and name ascending. Supports keyword search and attendance-mode filtering. Publicly accessible; when an authenticated user token is provided, the response includes the sponsor amount field. Cached for 5 minutes.
- [Get a single sponsor](https://docs-connect-api-v3.eventtia.com/reference/getsponsor.md): Returns detailed information for a single sponsor. Requires attendee authentication. If the authenticated attendee is a representative of the sponsor, all fields are returned.
- [Update a sponsor](https://docs-connect-api-v3.eventtia.com/reference/updatesponsor.md): Updates an existing sponsor's profile information. Only the attendee who owns the sponsor can update it. Supports updating description, social links, branding, media info, and tags.
- [List checkpoints for an event](https://docs-connect-api-v3.eventtia.com/reference/listcheckpoints.md): Returns all active checkpoints for the given event. Each checkpoint includes its current checked-in attendee count, capacity configuration, checkpoint type (unique vs. multiple entry), and the list of allowed attendee type IDs. Responses are cached for 5 minutes.
- [Check in an attendee at a checkpoint](https://docs-connect-api-v3.eventtia.com/reference/checkinattendeeatcheckpoint.md): Checks in an attendee at the specified checkpoint. Looks up the attendee by UUID or email address. Marks the attendee as checked in and returns the updated checked-in count, the attendee ID, and any custom messages.  Fails with 422 if: - The attendee is not found or does not belong to this event - The checkpoint has reached capacity - The attendee is not in confirmed status - The attendee has an unpaid balance and their attendee type requires payment - The checkpoint type is 'unique' and the attendee is already checked in - The attendee's attendee type is not in the checkpoint's allowed list
- [Check out an attendee from a checkpoint](https://docs-connect-api-v3.eventtia.com/reference/checkoutattendee.md): Checks out an attendee from the specified checkpoint. Marks all active entrances for the attendee at this checkpoint as checked out and returns the updated checked-in count.  Fails with 422 if: - The attendee is not found by UUID - The attendee has no active entrance at this checkpoint
- [List attendees checked in at a checkpoint](https://docs-connect-api-v3.eventtia.com/reference/listcheckpointcheckins.md): Returns a paginated list of distinct attendees who have checked in at the specified checkpoint. Supports filtering by current check-in/check-out status, keyword search (matches attendee name or email), and sorting. The response includes a `total_records` meta field with the distinct attendee count.  When `only_ids` is present, returns a flat array of attendee IDs instead of full resources.
- [Batch check-in/check-out attendees](https://docs-connect-api-v3.eventtia.com/reference/batchcheckinattendeesatcheckpoints.md): Submits multiple check-in or check-out operations for background processing. Designed for offline sync scenarios where the check-in app accumulates operations while offline and submits them in bulk when connectivity is restored.  Each entry in the `checkpoints` array specifies an attendee UUID, checkpoint ID, action type, and optional action timestamp. Returns 200 immediately; operations run in the background.
- [List all countries](https://docs-connect-api-v3.eventtia.com/reference/listcountries.md): Returns a paginated list of all countries, ordered alphabetically by name. Cached for 15 days. No authentication required.
- [List regions for a country](https://docs-connect-api-v3.eventtia.com/reference/listregions.md): Returns a paginated list of regions (states/provinces) for the given country, ordered alphabetically by name. Cached for 15 days. No authentication required.
- [Get a single region](https://docs-connect-api-v3.eventtia.com/reference/getregion.md): Returns a single region by ID within a country. Includes the country relationship. Cached for 15 days. No authentication required.
- [List cities for a region](https://docs-connect-api-v3.eventtia.com/reference/listcities.md): Returns a paginated list of cities for the given region, ordered alphabetically by name. Cached for 15 days. No authentication required.
- [Get a single city](https://docs-connect-api-v3.eventtia.com/reference/getcity.md): Returns a single city by ID. Includes the region and country relationships in the response. Cached for 15 days. No authentication required.
- [List available timezones](https://docs-connect-api-v3.eventtia.com/reference/listtimezones.md): Returns a sorted list of supported IANA timezone identifiers (e.g. `America/New_York`, `Europe/London`). Useful for populating timezone selectors in forms. Cached for 15 days. No authentication required.