Signup widgets (a.k.a. signup forms / form builder)

Also known as: signup forms, subscribe forms, email capture forms, form builder, embed form. The /signup-builder page in the console is where you build these.

Widgets are embeddable forms that add contacts to a list when a visitor submits an email. They're the simplest way to grow an audience from your website — drop a <script> tag in and you have a subscribe form.

Creating a widget / form

Open Contacts → Signup widgets → Create widget (or /signup-builder/new). The form builder has four configuration sections:

Form fields — which inputs to show (email is required; first name, last name, custom fields optional).
Typography — font family, weight, sizes for label / input / CTA / success message.
Layout — stacked vs. inline, spacing, border radius, background color, button alignment.
Behavior — target list, display mode (inline / modal / footer bar / slide-in), post-submit action (message / redirect / both).

Embedding

Copy the generated <script> tag and paste it into your site:

<script
  src="https://app.aigeon.ai/signup/embed.js"
  data-widget-id="sw_abc123"
  async
></script>
<div data-aigeon-signup></div>

The script loads Aigeon's widget runtime and replaces the <div> with your configured form.

API alternative

If you'd rather render the form yourself, post directly to:

POST https://api.aigeon.ai/api/v1/signup-widget/subscribe
Content-Type: application/json

{ "widget_id": "sw_abc123", "email": "alice@example.com" }

This endpoint doesn't require auth — it validates the origin domain against the widget's allowlist instead.