Integrations

Connect your forms to external services like email marketing platforms, CRMs, and more. Automatically send leads and data where you need them.

Available integrations

Email marketing

CRM

Automation

Setting up integrations

Global configuration

Some integrations require account-level setup:

1. Go to Fodo Forms → Settings → Integrations
2. Select the integration
3. Enter API credentials
4. Test connection

Per-form configuration

Enable and configure for each form:

1. Edit your form
2. Go to Settings → Integrations
3. Enable desired integration
4. Map form fields to service fields
5. Configure options (lists, tags, etc.)

Mailchimp

Setup

1. Go to Fodo Forms → Settings → Integrations → Mailchimp
2. Enter your Mailchimp API Key
3. Click Connect

Form configuration

1. Edit your form
2. Enable Mailchimp in integrations
3. Select audience (list)
4. Map fields:

Form Field    →  Mailchimp Field
───────────────────────────────────
email         →  Email Address
first_name    →  FNAME
last_name     →  LNAME
company       →  COMPANY

Options

Zapier

Connect to thousands of apps through Zapier webhooks.

Setup

1. Create a Zap in Zapier
2. Choose Webhooks by Zapier as trigger
3. Select Catch Hook
4. Copy the webhook URL
5. In your form settings, enable Zapier
6. Paste the webhook URL
7. Submit a test entry
8. Complete Zap setup in Zapier

Data sent

Each submission sends:

{
  "form_id": 123,
  "form_title": "Contact Form",
  "entry_id": 456,
  "submitted_at": "2024-01-15T14:30:00Z",
  "name": "John Smith",
  "email": "john@example.com",
  "message": "Hello..."
}

Popular zaps

• Add to Google Sheets
• Create Trello cards
• Send Slack notifications
• Add to CRM
• Create calendar events

Webhooks

Send form data to any URL endpoint.

Setup

1. Enable Webhooks for your form
2. Enter endpoint URL
3. Configure headers if needed
4. Set secret for verification

Payload format

{
  "event": "form_submission",
  "form_id": 123,
  "form_title": "Contact Form",
  "entry_id": 456,
  "submitted_at": "2024-01-15T14:30:00Z",
  "fields": {
    "name": "John Smith",
    "email": "john@example.com",
    "message": "Hello..."
  }
}

Security

Each request includes a signature header:

X-Fodo-Signature: sha256=abc123...

Verify in your endpoint:

$payload = file_get_contents('php://input');
$signature = hash_hmac('sha256', $payload, $your_secret);
$valid = hash_equals($signature, $_SERVER['HTTP_X_FODO_SIGNATURE']);

Retry logic

Failed webhooks are retried:

• 1st retry: 5 minutes
• 2nd retry: 30 minutes
• 3rd retry: 2 hours
• Then marked as failed

Field mapping

Map form fields to integration fields:

Simple mapping

Form Field  →  Integration Field
─────────────────────────────────
email       →  Email
name        →  Full Name

Split fields

Some integrations want separate first/last name:

first_name  →  First Name
last_name   →  Last Name

Or split a full name field:

name (split) →  First Name, Last Name

Custom fields

Map to custom fields in your integration:

company     →  Custom: Company Name
source      →  Custom: Lead Source

Conditional integrations

Only send to integrations when conditions are met:

Send to Mailchimp when:
  - newsletter_optin is checked

Send to Sales CRM when:
  - inquiry_type is "sales"
  - budget greater than 1000

Error handling

Integration failures

If an integration fails:

1. Form submission still saves locally
2. Email notifications still send
3. Error is logged
4. Retry is attempted (for webhooks)

Viewing errors

Go to Fodo Forms → Logs to see integration errors:

[ERROR] Mailchimp: Invalid API key
[ERROR] Webhook: Connection timeout
[WARN] Zapier: Rate limit exceeded, retrying...

Testing

Test mode

Some integrations support test mode:

• Use test/sandbox accounts
• Verify data is received correctly
• Check field mapping

Manual test

1. Submit a test entry
2. Check the integration service
3. Verify data appears correctly
4. Check for mapping issues