Integrations

Setup

Install and configure the FilaForms integrations package.

The integrations package is a separate, paid add-on. It is not included with your filaforms/core license. Contact hello@filaforms.app to purchase access — you will receive the credentials needed to composer require filaforms/integrations.

The integrations package is optional, sold separately from filaforms/core, and requires filaforms/core to be installed.

Installation

Install Package

Terminal

composer require filaforms/integrations

Run the Install Command

Terminal

php artisan filaforms-integrations:install

This publishes the config file, publishes the migrations, and runs them in one step. Confirm each prompt to continue.

This creates the following tables:

integration_connections — OAuth accounts and credentials (encrypted)
form_integrations — Per-form integration configurations
integration_deliveries — Delivery log for tracking webhook/API calls
webhook_subscriptions — REST Hook subscriptions for automation platforms
form_submission_payments — Payment records linked to form submissions

Manual install instead? Run each step yourself:

Terminal

php artisan vendor:publish --tag="filaforms-integrations-config"
php artisan vendor:publish --tag="filaforms-integrations-migrations"
php artisan migrate

The migrations must be published before migrating — they don't auto-load. The publish step assigns each migration a timestamp in dependency order, which Laravel's migrator then runs in the correct sequence.

Auto-Discovery

When auto_discover is true (default), integration classes are automatically found by scanning the src/Integrations/ directory. No manual registration needed.

config/filaforms-integrations.php

'auto_discover' => false,

Architecture

The package is built on a 3-interface system:

Interface	Purpose	Examples
`IntegrationInterface`	Base contract for all integrations	All integrations
`ApiWriteIntegrationInterface`	API integrations with field mapping and OAuth	Google Sheets, CRMs
`ExternalIntegrationInterface`	Externally-configured integrations (info cards, no config form)	Zapier

Generic base classes (GenericApiIntegration, GenericOAuthIntegration) eliminate code duplication across integrations.

Two-Tier Connection Architecture

Integration Connections — OAuth accounts created on the main Integrations page. One connection can be reused across multiple forms.
Form Integrations — Per-form configuration that references a connection and stores integration-specific settings (spreadsheet selection, field mapping, etc.).

Troubleshooting

"no such table: integration_connections"

You ran composer require filaforms/integrations and went straight to php artisan migrate. The migrations don't auto-load — they need to be published first. Run the install command:

Terminal

php artisan filaforms-integrations:install

Or do it manually with the three steps above.

Public Forms

Share forms via public URLs and embed them in your application.

Configuration

Configure integration credentials, field mapping, and OAuth settings.