---
title: Smeetz
slug: smeetz
createdAt: 2026-05-06T11:41:02.813Z
---

Easily sync your shows, guest badges, and volunteer badges with the Smeetz integration. In this article, we will take you step by step through setting up this integration.

Before continuing, make sure you have access to the Smeetz dashboard [https://app.smeetz.com/](https://app.smeetz.com/) and the integration settings in your Fiona.&#x20;

## Setting up the integration

To successfully set up an integration with Smeetz, you will need to:&#x20;

- Add an Smeetz Base URI and API key to the integration settings&#x20;
- Map fields between Fiona and Smeetz

### Integration Settings&#x20;

To set up your integration, you need to add two values from Smeetz to Fiona. Log in to [https://app.smeetz.com/](https://app.smeetz.com/) to retrieve the following two values.&#x20;

- **Base URI** - This is `https://api.smeetz.com/org/prod/nl/v1/`unless communicated otherwise.&#x20;
- **API key&#x20;**- You can retrieve the API key from the Smeetz Back Office. Once logged i , you can find your API key by clicking on the button with the nine squares at the top right of the screen. Next, head to "integrations" and copy the API key. Note that each Smeetz Group ID has its own API key.&#x20;

:::Paragraph{indent="1"}
Next, paste the API key in the integration settings of Fiona to complete the first step of the integration setup.&#x20;
:::

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/9s9kwIqCC8lWHhRl6xvWG_.blob" size="56" width="841" height="262" position="center" caption="API key Smeetz" alt="API key Smeetz" darkWidth="841" darkHeight="262" showCaption="true"}

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/BohB7WdoKJ2xrjst5fxNV_image.png" size="62" width="495" height="120" position="center" caption="Smeetz Integration Settings" alt="Smeetz Integration Settings" darkWidth="495" darkHeight="120" showCaption="true"}

### Mappings

**Custom mappings**

Mapping is the process of connecting an item's ID from Smeetz to a value in Fiona. This way, Fiona knows what show type or badge type belongs to which price grid or membership in Smeetz. To finish the integration setup, you need to map the following fields:&#x20;

- **Price grid map&#x20;**- use this mapping to map your Show Audience Types in Fiona to your Pricing grids in Smeetz. You can edit your Audience Types through the LookupList **ShowPublicTypes** in Fiona.&#x20;

:::Paragraph{indent="1"}
In Smeetz, you can configure your pricing grids in your account details. You will find this by clicking on your username on the top right of the screen **> Account details > Pricing grids.&#x20;**&#x57;hile setting up the pricing grids in Smeetz, make sure not to use any variations within one pricing grid. This way, all your audience types can be mapped to a pricing grid in Smeetz.
:::

:::Paragraph{indent="1"}
The ID of the items in Smeetz can always be found in the URL of the specific pricing grid. Copy this ID and paste it into the mapping table in Fiona.&#x20;
:::

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/3d8h19TidDV6jP4ePLg99_2cfb8b75-15af-4766-98d6-50b425fb8738.png" size="58" width="706" height="340" darkWidth="706" darkHeight="340" position="center" showCaption="false"}

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/aVaPovyQsIoCGlpj1Kbyd_image.png" size="64" width="621" height="322" position="center" caption="Example of a Price grid map" alt="Mapping" darkWidth="621" darkHeight="322" showCaption="true"}

- **Membership map** - use this mapping to define which Guest Badges belong to which Smeetz membership. You can set up your badges in your Guestbooks.&#x20;

:::Paragraph{indent="1"}
You can configure your memberships in the Smeetz back office by going to **Orders > Memberships**. You can copy the ID of each membership from the URL of the page.&#x20;
:::

- **Volunteer badges map&#x20;**- use this mapping to map Volunteer Badges from Fiona to Memberships in Smeetz. You can edit the list of badges through the Fiona Lookup list VolunteerBadgeTypes.&#x20;

:::Paragraph{indent="1"}
Fiona's Volunteer badges are also mapped to Memberships in Smeetz. You can find the ID by following the same steps as described above.&#x20;
:::

![](https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/5NT_zttSKSwbRAcIwRLSP_abfcac54-674b-47a4-8abd-caa4ef2cc546.png)

*Tip! Always fill in the default value in your mapping. This value will be used when no other mapping is provided, helping avoid errors during syncing.*

**Auto-created mapping**

Next to the custom mappings, Fiona also keeps track of one automatic mapping. This lets you keep track of the mapped values and make adjustments if needed.&#x20;

- **Activity map -&#x20;**&#x54;his mapping is automatically created when you publish shows. An activity is a combination of a location and an edition in Fiona. Syncing a show in Fiona will automatically create a location in Smeetz.&#x20;

## Publishing data

Once the integration is set up, you are ready to sync data. You can publish information from the following cards.&#x20;

- **Show** - Syncing a show from Fiona creates or updates an event in Smeetz. Smeetz returns an 'External event ID' on the show card in Fiona.
- **Guest badge** - Syncing a guest badge from Fiona creates a pass, a Membership Card in Smeetz. Smeetz returns a 'Code on badge' and, if applicable, a 'voucher code' to Fiona. These codes can then be used to print on badges or to communicate via email using the template editor.&#x20;

:::Paragraph{indent="1"}
Note: Only Guest badges with a status of "approved" or higher can be synced.
:::

- **Volunteer** - Syncing a volunteer also creates a pass, a Membership Card in Smeetz. Smeetz returns a 'Code on badge' and, if applicable, a 'voucher code' to Fiona.



::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/0fLVycvbqdH5M4O1POtwm_image.png" size="62" width="851" height="585" position="center" caption="Example of a Guest badge in Fiona" alt="Example guest badge " darkWidth="851" darkHeight="585" showCaption="true"}

## QR code on Badge

You can use the 'Code on badge' and 'voucher code' in templates for volunteer and guest badges. These codes can then be used to generate passes with personal booking information or scannable QR codes.&#x20;

Try, for example, the following code on a GuestBadge template to generate a QR code on a badge. &#x20;

:::CodeblockTabs
```html
  {{ #if Code }}
  	<img class="qr" src="https://api.qrserver.com/v1/create-qr-code/?data={{code}}&size=100x100" />
  {{ /if }}
```

```css
.badge img.qr {
  width: 3cm;
  height: 3cm;  
}
```
:::

Check out our full template documentation [Templates](https://docs.fiona-festival.com/) for more information. Or write [support@fiona-festival.com](mailto\:support@fiona-festival.com) if you need help setting this up.&#x20;
