1. Concepts
  2. Public Forms

Concepts

Public Forms

A public form that can expose an action to the outside world, allowing anyone to submit data to your stubs without needing to authenticate with the Stubber platform

Sometimes you want to collect data from the public or a specific user within a stub process.
You can expose an action as a public form, which generates a unique URL that can be shared with anyone, allowing them to submit data to your stubs without needing to authenticate.

Features

  • Customizable form look and feel, allowing you to tailor the form to suit your branding in HTML and CSS
  • Supports all the field types available in the platform, allowing you to collect a wide variety of data (Eg. maps, file uploads, signature fields etc.)
  • The form auto-expires when the action is no longer available on the specific stub, ensuring that the form is only active when it can be submitted successfully
  • Submissions run the action on the stub as if the data had been submitted from within the platform, allowing you to leverage all the capabilities of actions and tasks in your form submissions.

Use Cases

  • If an AI agent needs to collect a large number of data points from a user, the agent can send the user a link to a public form, allowing them to submit the data and then continue the conversation or process
  • You can use public forms to initiate a new stub, by setting an action on the _create context to be exposed as a public form. This allows you to create a form that anyone can submit to create a new stub and kick off a process, without needing to authenticate with the platform.

Detailed Information

  • Users can create a public form layout within the platform and customize it by using the built in AI agent
  • Any action can be then exposed as a public form by setting the public form setting on the action and setting a publicformlayoutuuid
  • When an action is available and set as a public form, the form will be available on the URL : https://forms.stubber.com/[stubref]/[action_name]
  • When the form is submitted, the action will execute on the stub with the submitted data as input
  • It is possible to inject dynamic data into the form layout using public form variables, which can be set on the action and referenced in the form HTML.