---
title: FilmFreeway
slug: filmfreeway
createdAt: 2026-01-27T13:04:44.330Z
---

Easily import your FilmFreeway submissions into Fiona as film cards!

## Setting up the integration

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

- Copy Fiona's webhook URL to FilmFreeway
- Subscribe to one or more events, and indicate to which event Fiona should listen
- Select an organisation activity you want to import submissions for (if applicable)
- Define default values
- Create mapping for countries & credit roles

## Webhook URL: from Fiona to FilmFreeway

In Fiona, you can navigate **Settings > Integrations > FilmFreeway&#x20;**&#x74;o land on the integration card. In the Webhook URL field, you can copy the URL with the copy button. In the FilmFreeway managing dashboard, you then open the "Webhooks" section:

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/iReypjKPQx2sDUItoKXB9_image.png" size="34" width="222" height="52" position="flex-start" darkWidth="222" darkHeight="52" showCaption="false"}

In the section, choose "Add a webhook" and paste the URL:

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/5YCrrRR2vbB7zGfBfXuKd_image.png" size="82" width="733" height="235" position="flex-start" darkWidth="733" darkHeight="235" showCaption="false"}

## Events

### Subscribe to events

Below the Webhook box, you can subscribe to various events. These events determine when Fiona should actually create a film card from a FilmFreeway submission. Note that **Fiona can only listen to one event at a time**, but you could change it up down the line and thus select more. We ask you to choose one or more of these three events:

- Submission status: submission.created --> Fiona creates a film card when someone submits their FilmFreeway form. If you use/want to use Fiona for your selection process, this is the one to pick.&#x20;
- Judging status: submission.judging\_status.updated --> Fiona creates a film card when the judging status is changed to 'Selected'. If you use FilmFreeway to select your films, you can opt for this event.&#x20;
- Flags: submission.flag.added --> Fiona creates a film card once you appoint the film a custom flag. **Note that when you create this flag, the title needs to include the word Fiona.** Subscribing/listening to this event allows you to be flexible regarding the moment of import.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/QAxnD2_wRVysvoUFjn8-c_image.png" size="88" width="719" height="297" position="flex-start" darkWidth="719" darkHeight="297" showCaption="false"}

### Indicate event to listen to

As said, Fiona can only listen to one event at a time, but you can change it at any point. In the 'Listen to event' field, you can choose from one of the three events mentioned above.

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/WCrAYOv5QApeQ5dYSfxSG_image.png" size="84" width="546" height="134" position="flex-start" darkWidth="546" darkHeight="134" showCaption="false"}

## Select organisation activity

On the integration card, you can also indicate for which organisation activity (Festival, Industry, etc.) you are importing submissions in the 'Submissions to' field. If you only have one organisation activity, this one will be listed by default.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/su2WBnWRMwNRLSeYmsixg_image.png" size="82" width="547" height="42" position="flex-start" showCaption="false"}

## Define default values

In order to import everything into Fiona correctly, you can set up some default values.

### Content types

When you use Fiona's assessment tool, it's important to indicate some default content types for the attachments that are submitted to FilmFreeway. Otherwise, it will be more difficult to set up the assessment form(s). If you don't use the assessment tool, you can skip this part.



::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/OxbPptgECr1neEbOx7p3J_image.png" size="74" width="589" height="43" position="flex-start" showCaption="false"}

The content type for attachments such as synopses, biographies, financial plans etc. can be determined with Content type (info). We recommended creating a general term (like "Info from entry") in the attachment content type lookup list, so these attachments can be easily identified & added to the assessment form.&#x20;

Any link or film still can be given a default content type through, respectively, the Content type (links) and Content type (stills) fields.&#x20;

### Credit roles

You can provide mapping to ensure credits are imported into Fiona correctly. However, because FilmFreeway lets applicants freely add new credit roles, you might miss a certain spelling or abbreviation here and there. We thus ask you to select a default credit role that can be appointed to any credit that could not be identified by Fiona. Fiona will list the originally entered description of the unidentified credit in a memo attachment in the Attachments section of the film card. Subsequently, in the Relations section, you can easily spot the unidentified credits through the default credit role and adjust them with the help of the memo.&#x20;

## Mapping

### Countries

FilmFreeway uses different phrasing for some countries/regions, so please check their list next to Fiona's countries lookup list to see if certain names need to be mapped. Example:

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/RheYeEWNwSulvaY8Sw3qq_image.png" size="82" width="488" height="98" position="flex-start" showCaption="false"}

### Credit roles

The credit roles Key cast, Directors, Writers & Producers can be easily mapped, as they are preset by FilmFreeway in their form. Any other credit role can be added without restriction, so we recommend including different spellings and abbreviations while mapping values. These can be divided by semicolons & without spaces.

::Image[]{src="https://api.archbee.com/api/optimize/Jb5LCrq9-vEh7pDapzR1e/RFkR3k-t8z1A96Pd5qNd4_image.png" size="82" width="562" height="31" position="flex-start" showCaption="false"}

