Chapter 2: Bringing Data In

Auto-Generated UI Forms

While APIs and Webhooks are incredibly powerful, sometimes you simply need to send a client a link to fill out their information.

To eliminate the need for you to build a custom frontend for every document pipeline, Strucsta automatically generates a hosted, production-ready UI form for any workflow that uses a Web Form Source as its ingest trigger.

How It Works

When you use the Blueprint Engine, it defines an expected JSON schema based on your prompt (e.g., expecting clientName, company, and budget). Strucsta reads this schema and instantly renders a clean, accessible React form.

If you update the schema in your workflow's Source Step—for example, adding a new required field—the hosted form updates immediately. There is no deployment step required on your end.

Accessing Your Forms

Every Web Form trigger generates a unique ID. You can access your form via two specific routing patterns, depending on whether you are testing internally or sending it to a client.

1. The Public Link (/form)

Pattern: https://strucsta.com/webhook/[trigger_id]/form

This is the standard, public-facing URL.

• Use this link to send directly to clients.
• Use this URL as the src attribute if you are embedding the form in an iframe on your WordPress, Webflow, or custom landing page.
• Upon submission, it displays a standard success message (or redirects to your configured success URL) while the engine processes the document in the background.

2. The Testing Link (/form-track)

Pattern: https://strucsta.com/webhook/[trigger_id]/form-track

This is the internal testing link, primarily used via the "Run Workflow" button in your dashboard.

• It displays the exact same form UI as the public link.
• The Difference: Upon submission, instead of a static success message, this link automatically redirects you into the Strucsta dashboard to watch the live Run Execution Logs. It is designed for developers and creators to immediately verify how the AI is reasoning with the newly submitted data.

Customizing the Form

Because Strucsta operates on the 70/30 Rule, the auto-generated form provides the scaffolding, but you remain in control of the details:

• Descriptions & Labels: You can edit the UI labels and add helper text directly within the Source Step configuration in the workflow editor.
• Hidden Fields: If you need to pass constant context (like an agentId or campaignSource), you can configure hidden fields that bypass the UI but are injected into the JSON payload upon submission.