> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conversion.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Zuddl

> Connect Zuddl to Conversion with a backend API key so event details, registrations, check-ins, and no-shows sync into your field events.

Zuddl connects with a backend API key, and everything in [Field Event Platform Sync](https://docs.conversion.ai/product-docs/campaigns/field-events/platform-sync/overview.md) applies to it. The same connection serves [Zuddl webinars](https://docs.conversion.ai/product-docs/campaigns/webinars/platform-sync/zuddl.md).

## Set up Zuddl

**Before you begin:**

* You're a workspace Administrator in Conversion.
* You can create API keys in Zuddl.

Your region (United States or European Union) is determined automatically from the key.

### Create a key in Zuddl

1. In Zuddl, go to **Settings → API Access Key**.
2. Generate a **Backend** key with read and write access. Only backend keys can read attendees, and write access lets Conversion register contacts for [Zuddl webinars](https://docs.conversion.ai/product-docs/campaigns/webinars/platform-sync/zuddl.md).
3. Copy the key.

### Connect it in Conversion

1. Go to **Settings → Integrations**.
2. Under **Field events**, click **Connect** on the **Zuddl** card.
3. Paste the key into **API key**.
4. Click **Connect**.

Once connected, the card shows **Connected** and your region.

## Manage the connection

Open the **⋮** menu on the **Zuddl** card:

* **Manage connection** asks for the key again. Use it to replace the key.
* **Manage fields** maps registration questions to fields. See [Registration questions](#registration-questions).
* **Disconnect** removes the integration. Connected field events and webinars keep their members but stop syncing, and Conversion stops registering contacts on Zuddl.

## Choosing an event

The field event picker lists only Zuddl's in-person events. Webinars and virtual events connect to a [Conversion webinar](https://docs.conversion.ai/product-docs/campaigns/webinars/platform-sync/zuddl.md) instead:

| Zuddl event | Listed for field events |
| - | - |
| **Field event** | Yes |
| **Conference** (in person or hybrid) | Yes |
| **Virtual event** | No. Connect it to a webinar. |
| **Webinar** | No. Connect it to a webinar. |
| **Third-party event** | No |

Events are listed latest start first. Search by name, or narrow by start date, to find older ones.

## Registration and attendance

Zuddl webhooks can only be created by hand in Zuddl's dashboard, so Conversion syncs **hourly**. A registration made on Zuddl appears within the hour.

| On Zuddl | In Conversion |
| - | - |
| **Registered** | Your **Registered** status |
| **Pending** (awaiting approval) | Your **Pending Approval** status, if the type maps one |
| **Attended in person**, **Attended virtually**, or **Attended both** | Your **Attended** status |
| **No show** | Your **No Show** status |
| **Rejected** | Removed from the event |
| **Incomplete** or **Approved not registered** | Ignored. Not a finished registration. |

Zuddl has no waitlist, so nothing lands on your waitlisted status.

Speakers, sponsors, moderators, and organizers who aren't also attendees are skipped, as are registrations without an email address to match a contact by.

Zuddl marks no-shows about an hour after an event ends, usually before the [no-show sweep](https://docs.conversion.ai/product-docs/campaigns/field-events/platform-sync/overview.md#attendance) runs. The sweep still runs as a backstop.

## Registration questions

Answers to an event's registration form can fill contact, company, and campaign member fields. You choose which fields each question fills.

### Where questions come from

* **Zuddl's profile questions:** **Company**, **Job Title**, **Phone Number**, **Industry**, **Country**, and **LinkedIn**.
* **Your own registration fields:** added once someone answers them. Zuddl's API identifies them by field ID, not label, so they appear under that ID.

Three profile questions come mapped:

| Question | Fills |
| - | - |
| **Company** | The company's name |
| **Job Title** | The contact's **Job Title** |
| **Phone Number** | The contact's **Phone** |

A default is skipped if another Zuddl question already fills that field.

### Map a question to a field

1. Go to **Settings → Integrations**.
2. On the **Zuddl** card, open the **⋮** menu.
3. Click **Manage fields**.
4. Map the question the same way as for Luma. See [Map a question to a field](https://docs.conversion.ai/product-docs/campaigns/field-events/platform-sync/luma.md#map-a-question-to-a-field) and [How answers are written](https://docs.conversion.ai/product-docs/campaigns/field-events/platform-sync/luma.md#how-answers-are-written).

## Event details

Zuddl fills in the name, start and end times, time zone, format, status, website URL, venue, and address. The format is in-person for a Zuddl field event and follows the conference's own format otherwise.

Zuddl's API doesn't expose capacity, an organizer, or whether registration requires approval, so those fields stay as you set them.

## Limits

Zuddl allows each organization 10 API requests per second and 10,000 a day by default, shared across everything using your keys. Conversion reads every registration from an event's start until a day after it ends, so no check-in is missed, and only changed registrations otherwise, which keeps it well inside those limits. If another tool uses most of the daily quota, Zuddl may refuse requests until the next day; the sync retries and catches up. Your Zuddl Customer Success Manager can raise the limits.

## Troubleshooting

| Problem | Likely cause |
| - | - |
| **Connect** fails | The key is wrong, was revoked, or wasn't generated for backend use. Generate a new backend key and try again. |
| An event is missing from the picker | It's a webinar, virtual event, or third-party event, it's already connected to another field event, or it's further down the list than the first page. Search by name. |
| A registrant on Zuddl isn't in Conversion | They have no email address, their registration is **Incomplete** or **Approved not registered**, they're on the event only as a speaker or sponsor, or the hourly sync hasn't run. |
| Someone checked in on Zuddl still shows **Registered** | Check-ins arrive on the hourly sync. **Re-sync** refreshes the event's details, not its registrations, so wait for the next sync. |
| The Zuddl card no longer shows **Connected** | Zuddl rejected the key. It was usually revoked or regenerated. Reconnect with a current backend key. |
| A question is missing from **Manage fields** | Conversion hasn't seen it yet. It appears once someone answers it. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.