Webflow Forms
Connect the Sequenzy app to a Webflow site to turn new native form submissions into Sequenzy subscribers andwebflow.form_submission events. Sequenzy
registers the required webhook for you; you do not need to paste an endpoint
into Webflow or add custom code to the site.
Before You Start
You need:- A Webflow site with at least one native Webflow form
- Permission to authorize that site in Webflow
- A valid email field in each form you want Sequenzy to process
- A published site for the end-to-end test
Capture starts after the Webflow connection finishes. Existing Webflow form
submissions are not imported.
Connect A Site Or Workspace
Install From The Webflow Marketplace
- Install Sequenzy from the Webflow Marketplace.
- Sign in to Sequenzy or create an account.
- On Webflow’s authorization screen, choose the site or sites Sequenzy may access and approve the requested permissions.
- Return to Sequenzy and wait until the Webflow integration shows Connected.
- Open Settings → Integrations → Websites & Forms → Webflow → Settings to confirm the connected sites and choose the destination lists.
Connect From Sequenzy
- Open Settings → Integrations → Websites & Forms.
- Find Webflow and click Connect.
- Choose the Webflow site or sites on Webflow’s authorization screen.
- Back in Sequenzy, open Webflow → Settings and select which of the authorized sites should send submissions to this Sequenzy workspace.
- Choose the subscriber list routing and click Save.
How Forms Are Selected
Site selection controls form capture. Sequenzy registers oneform_submission webhook for each selected site, and that webhook receives
submissions from every native Webflow form on that site.
- You do not select or map individual forms during setup.
- Adding or renaming a native form does not require reconnecting Sequenzy.
- Forms on an unselected site are not captured.
- Embedded third-party forms and custom forms that bypass Webflow’s native form submission system do not trigger the Webflow webhook.
How Form Fields Are Mapped
Sequenzy maps each accepted submission as follows:
Webflow-generated numeric suffixes do not prevent common contact fields from
matching. For example,
email-18, first-name-7, and last-name-7 map to the
subscriber’s email, first name, and last name.
Other form fields are retained in the event’s
formData; they are not copied
automatically to same-named subscriber custom attributes. Use the event
payload directly in a sequence or create a Sequenzy sync rule when you want
event values to update audience data.Choose Subscriber Lists
Open Webflow → Settings → Add subscribers to and choose one of these modes:- Workspace defaults — use the workspace’s default subscriber lists. If no defaults are configured, Sequenzy uses all current workspace lists.
- Specific lists — add the subscriber only to the selected lists.
- No lists — create or merge the subscriber without adding list membership.
webflow.form_submission event is still recorded when you choose No
lists. Changing this setting affects future submissions and does not remove
existing list memberships.
webflow.form_submission Event
Every accepted submission records an event named
webflow.form_submission. Its properties have this shape:
formData match the
field names sent by Webflow, including capitalization and spaces.
Trigger A Sequence From A Submission
- Publish the Webflow site and send one test submission so the event appears in Sequenzy.
- In Sequenzy, create or open a sequence.
- Set the trigger type to Event received.
- Select
webflow.form_submissionas the event name. - Add any conditions you need. For example, use
event.formData.Planto branch on the submittedPlanfield or useevent.webflowFormIdto limit the sequence to one form. - Add the email and action steps, save, test, and activate the sequence.
Verify A Submission
- Confirm the Webflow integration shows Connected, with the expected site name and no Needs attention warning.
- Submit a published Webflow form using a unique test email address.
- Open Subscribers, search for that email, and open the profile. Confirm the mapped first name, last name, custom attributes, and list memberships.
- Open Settings → Events and find
webflow.form_submission. Its activity count should include the test contact. - Open the subscriber’s activity and inspect the event to confirm
formData,webflowFormId,webflowFormName, andwebflowSubmittedAtmatch the test.
- The form was submitted on the published site.
- The form belongs to a site selected in Webflow → Settings.
- The integration is not showing Finishing setup or Needs attention.
- The submission contains a valid email address.
- The form is a native Webflow form, not a third-party embed.
Limitations And Expected Form Structure
- A valid email address is required. Submissions without one are acknowledged
but do not create a subscriber or a
webflow.form_submissionevent. - Form selection is site-wide; there is no per-form inclusion list in the integration settings.
- Only new submissions received after connection are captured. The integration does not import historical Webflow form submissions.
- Arbitrary form fields stay in event
formData; only detected contact fields and Webflow metadata are written to the subscriber profile automatically. - Sequenzy does not change the form, its fields, page design, CMS content, custom code, domains, or publish state.
Why Sequenzy Requests Edit Site Data
Webflow labels thesites:write permission as Edit Site data. Sequenzy
requires it only to manage the webhook that powers automatic, real-time form
capture:
- After connection or a site-selection change, Sequenzy calls
POST /v2/sites/{siteId}/webhooksfor each selected site. - The request creates a
form_submissionwebhook whose only configuration is the trigger type and the Sequenzy callback URL. - When a site is deselected or the integration is disconnected, Sequenzy removes only its own matching webhook registration.
sites:write. Sequenzy does not
use this permission to edit pages, Designer content, forms or form fields, CMS
collections, assets, site settings, domains, custom code, or the site’s publish
state. Removing the permission would prevent Sequenzy from registering the
signed webhook and would disable the integration’s core form-capture behavior.
Webflow Permissions
Sequenzy verifies the timestamp and signature on OAuth app webhook requests
before accepting them. Disconnecting the integration queues removal of the
Sequenzy-managed webhooks.