Embedded forms

Embedded forms let any website — not just a connected store — collect subscribers into Senderz. Add a form to your page, include the Senderz script, and submissions upsert contacts and enrol welcome flows.

Install

Copy the snippet

From Settings → Embedded Forms, copy the install snippet. It’s built from your active API key and workspace ID.

Add the form markup

Add a form with the Senderz data attributes to your page:

<form data-senderz-form data-tenant="YOUR_WORKSPACE_ID" data-key="YOUR_API_KEY">
  <input type="email" name="email" required />
  <input type="tel" name="phone" />
  <button type="submit">Subscribe</button>
</form>
<script src="https://senderz.app/forms/senderz-form.js" async></script>

Set an origin allowlist

In the same settings section, add the origins allowed to submit. An empty list accepts from anywhere; a configured list rejects other origins with 403.

What happens on submit

The bundle scans the page for data-senderz-form elements and POSTs each submission to POST /forms/subscribe with your workspace ID + API key headers. Senderz:

upserts the contact,
subscribes email (source embedded_form),
routes any extra fields to the right contact property,
enrols contact_created / list_joined flows,
dispatches a senderz:subscribed DOM event you can hook.

Security

The data-form-id attribute is client-supplied and forgeable, so the origin allowlist is workspace-level, not per-form. Requiring the embedded_forms feature and checking the Origin header is the real gate.

See the Forms API reference for the exact request and response shapes.

Inbound webhooks Meta audiences

⌘I

Overview

E-commerce

Automation & no-code

Advertising

AI

Install

What happens on submit

Security

​Install

​What happens on submit

​Security

Install

What happens on submit

Security