Zapier

Authentication (OAuth v2)

In your Zapier app, go to Authentication and select OAuth v2.

Step 1 -- Configure Fields: Skip this step (no custom fields needed).

Step 2 -- Redirect URL: Copy the redirect URL -- you'll use it when creating the Passport client (see Prerequisites above).

Step 3 -- Application Credentials:

Step 4 -- Endpoint Configuration:

Set Scope to forms:read and check "Automatically refresh on unauthorized error".

Step 5 -- Test: Click Save & Continue, then click the Sign in button to connect an account. This opens the OAuth authorization page -- log in and approve access. A successful test returns:

{
  "status": "authenticated",
  "message": "API credentials are valid"
}

Create the Form List Trigger

Before creating the main trigger, create a helper trigger that powers the form dropdown.

Go to Triggers and create a new trigger:

Skip the Input Designer (no input fields needed).

In API Configuration, set the polling URL to:

GET https://{domain}/api/filaforms/automations/forms

Test to verify it returns your forms list, then save.

Create the New Form Submission Trigger

Go to Triggers and create a new trigger:

Input Designer: Add a form_id field so users can select which form to watch:

Configure the REST Hook API

In the API Configuration for the New Form Submission trigger, select REST Hook as the trigger type. Switch each endpoint to Code Mode and use the following:

Subscribe (POST):

const options = {
  url: 'https://{domain}/api/filaforms/automations/subscribe',
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json'
  },
  body: {
    'target_url': bundle.targetUrl,
    'form_id': bundle.inputData.form_id,
    'event': 'submission.created',
    'platform': 'zapier'
  }
};

return z.request(options)
  .then((response) => {
    response.throwForStatus();
    return response.json;
  });

Unsubscribe (DELETE):

const options = {
  url: 'https://{domain}/api/filaforms/automations/unsubscribe/' + bundle.subscribeData.id,
  method: 'DELETE',
  headers: {
    'Accept': 'application/json'
  }
};

return z.request(options)
  .then((response) => {
    response.throwForStatus();
    return response.json;
  });

Perform List (GET):

const options = {
  url: 'https://{domain}/api/filaforms/automations/submissions',
  method: 'GET',
  headers: {
    'Accept': 'application/json'
  },
  params: {
    'form_id': bundle.inputData.form_id
  }
};

return z.request(options)
  .then((response) => {
    response.throwForStatus();
    return response.json;
  });

Leave the Perform function as default.

Save and test -- Zapier will create a test subscription and pull sample data from your forms.