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:
- 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. - Render it using that schema, respecting each field's
conditionalrule (only show a field when its target field's value matches). - Submit it:
POST /public/forms/:formId/submitwith 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.
Last updated on