Exhibitor import

Use these endpoints to import exhibitors for a specific event via an Excel file or JSON data.
The import process is asynchronous.

1. Start an import task.
   Use 'POST Import Exhibitors by Excel' or 'POST Import Exhibitors by JSON'.

2. Poll the task status until it is complete.
   Use 'GET Import Task Status'.

3. Retrieve the final result with detailed success/error information.
   Use 'GET Import Task Result'.

Data Structure Definition

This API describes the data objects used for importing exhibitor-related information into the system.

All objects defined here can be used for both file-based imports (e.g., CSV or XLSX) and payload-based imports (JSON).

StartFragment

Exhibitor Object

Describes an exhibitor to be imported.

Fields

---

Fairevent Appearance Object

Describes a specific trade fair appearance of an exhibitor.

Each appearance is linked to the event context of the import and requires a valid Exhibitor_ExternalId.

Fields

---

Contact Data

All contact imports require the field Exhibitor_ExternalId to assign contacts to the correct exhibitor.

a) Email Contacts

Describes a business email address of the exhibitor.

{email} represents a valid email address.
{display} may include letters, digits, and spaces.

---

b) Phone Contacts

Describes a business phone number.

---

c) Generic Contact Data

Describes any contact data type (e.g., fax, secondary email, etc.).

---

Address Data

Describes address data associated with the exhibitor.

To import multiple addresses, the exhibitor entry must be repeated with distinct address data.

---

Ticket Quotas

Optional ticket quotas may be defined using the format:

TicketQuota{XXX}
TicketQuota{XXX}ShortCode

Where {XXX} is a sequential integer (1 ≤ {XXX} ≤ n).

Short codes apply to 1:n ticket models and are mandatory if such an article is referenced.

If quotas for a given appearance already exist, they will be updated or extended — reductions are not performed.
FaireventAppearance_ExternalId is mandatory to assign ticket quotas.

---

User Accounts

If configured, user accounts can be automatically created for imported exhibitors.

A valid email address (EMail) is mandatory.

If FaireventAppearance_ExternalId is provided, the user receives access to that event appearance.

Imported users automatically receive the roles "BaseRole" and "Exhibitor".

If configured, activation emails will be sent after import for all newly created accounts.