threadliner
Forms

Embedding a form

Embed a published form on a WordPress site, or build your own embed against the public API.

There isn't a hosted, standalone page for a form (no "direct link" you can just send people to) — a form is embedded into a page you control, either through the WordPress plugin or by talking to the public API directly.

WordPress

If your site runs WordPress, use the Threadliner Form block — see Connecting a WordPress site to install and connect the plugin, then add the block to any page or post and pick the form. This is the only ready-made embed option; there's no separate iframe snippet to copy.

Any other site

For a non-WordPress site, build the embed against the same public API the WordPress plugin uses — there's no drop-in <script> tag for this yet, so it's a small integration, not a copy-paste snippet:

  1. Fetch the form's schema: GET /public/forms/:formId — returns the field list (type, label, options, required, conditional rules) so you can render the form client-side.
  2. Render it using that schema, respecting each field's conditional rule (only show a field when its target field's value matches).
  3. Submit it: POST /public/forms/:formId/submit with the field values keyed by field ID.

Both endpoints are public and unauthenticated — the form ID itself is what scopes the request to your workspace, and only forms with status PUBLISHED respond (see Building a form). The submit endpoint is rate-limited to 20 requests per minute per form, to keep it spam-resistant since it doesn't require an API key.

Full request/response shapes for both endpoints are in the API reference.

Was this page helpful?

Last updated on

On this page