Integrations

Connect BuoyForms to the systems that process submissions, alerts, and CRM follow-up.

Available Integrations

Signed Webhooks

Signed webhooks are the primary self-serve automation path. They can send submission events to your own API, middleware, or automation tools that accept incoming webhook requests.

1. 1

   Open Integration Settings

   Go to Settings > Integrations. ::

2. 2

   Add a Webhook

   Click Add Integration > Webhook and enter the HTTPS endpoint that should receive events. ::

3. 3

   Select Events

   Choose which form and submission events should trigger the webhook. ::

4. 4

   Verify Signatures

   Configure the receiving system to verify X-BuoyForms-Signature and X-BuoyForms-Timestamp. ::

5. 5

   Test Delivery

   Send a test event and confirm the receiving system returns a 2xx response. ::

Supported Events:

Salesforce Integration Suite

Salesforce-connected workflows are available through the Salesforce Integration Suite. This is a scoped implementation path for OAuth connection, object selection, field mapping, sandbox validation, launch support, sync logs, and retry handling.

1. 1

   Connect Salesforce

   An authorized workspace admin connects Salesforce through the BuoyForms OAuth flow. ::

2. 2

   Choose Object and Operation

   Select the Salesforce object, upsert key, and operation for the form feed. ::

3. 3

   Map Fields

   Map BuoyForms fields, hidden URL fields, and submission metadata to Salesforce fields. ::

4. 4

   Validate in Sandbox

   Run a test mapping against a sandbox or approved test record before launch. ::

5. 5

   Enable the Feed

   Enable the Salesforce feed for the specific form only after validation passes. ::

Coming Soon and Requestable Providers

Some providers are planned or available only through custom work today:

Form-Level Configuration

Each integration can be customized per form:

1. 1

   Open Form Settings

   Open a form's Settings. ::

2. 2

   Go to Integrations Tab

   Go to the Integrations tab. ::

3. 3

   Enable or Disable

   Enable only the integrations that should run for this form. ::

4. 4

   Configure Field Mappings

   Configure field mappings to control which data is sent. ::

5. 5

   Review Logs

   Use the integration logs to confirm deliveries, retries, and external record links. ::

Event Types

Webhook Payloads

All webhooks include:

{
  "event": "submission.created",
  "timestamp": "2025-11-27T10:30:00Z",
  "organizationId": "org_...",
  "formId": "form_...",
  "submissionId": "sub_...",
  "data": {
    "fields": { ... },
    "metadata": { ... }
  }
}

Webhook Headers

Outbound webhook requests include these headers:

For submission events, Idempotency-Key uses <submissionId>-<event>, for example sub_123-form.submission.created. If a webhook payload does not include a submission ID, BuoyForms falls back to <deliveryId>-<event>.

Retry Logic

Failed webhook deliveries retry automatically:

View delivery status in Settings > Integrations > Logs.

Security

• Webhook payloads include HMAC signatures for verification
• OAuth tokens are encrypted at rest for OAuth-based providers
• Credentials are scoped per organization
• Form-level feeds can be disabled independently
• Revoke access anytime from integration settings

Troubleshooting