This trigger runs when someone submits a specific form view. All submitted fields are available to the next steps.Documentation Index
Fetch the complete documentation index at: https://help.teable.ai/llms.txt
Use this file to discover all available pages before exploring further.
Build with AI
Open the AI Chat in your table’s right sidebar and describe what you want. AI handles everything: it chooses the right trigger, maps the relevant fields, and sets up all actions automatically. Describe the goal once, and the workflow is ready — no manual setup needed. Example: “When someone submits the contact form, send a confirmation email.”Configuration
| Setting | Required | Description |
|---|---|---|
| Table | Yes | The table the form belongs to |
| Form | Yes | The specific form view to watch for submissions |
How to set it up
- Make sure you already have a form view on your table. If not, create one by clicking + in the view bar and selecting Form.
- Open your automation and add a new trigger.
- Select When form submitted.
- Choose the Table that contains the form.
- Choose the Form view you want to monitor.
- Save and activate the automation.
- Add your action steps. Click + in any action field to reference the submitted data — all form fields are available.
What data is available to next steps
When a form is submitted, the following data is passed to your workflow:- Record ID — the unique identifier of the newly created record.
- All submitted field values — every field that was included in the form (text, email, numbers, dates, selections, attachments, etc.) can be referenced by clicking + in subsequent actions.
Form submission also creates a record
It is important to understand that a form submission and a record creation are the same event at the data level. When someone submits a form, a new record is added to the table. This means:- If you also have a When record created automation on the same table, both automations will fire on a form submission.
- To avoid duplicate processing, either use the Form Submitted trigger exclusively or add a filter to the Record Created trigger that excludes form-originated records.
A form submission is essentially a record creation. If the same table also has a “When record created” trigger configured, both workflows will run.
When to use
- Send a confirmation email after submission. When a customer fills out a contact form, automatically send them a “thank you” email with details of their submission.
- Auto-classify new support tickets with AI. Use the AI Generate action to categorize the ticket based on the description the user submitted.
- Notify your team about incoming applications. When someone submits a job application form, post a notification to Slack or email the hiring team.
- Create linked records in other tables. When an order form is submitted, automatically create records in an “Order Items” table or a “Shipments” table.
- Validate and flag submissions. Check if required information is complete or if a value is out of range, and update a status field to “Needs Review” if something looks off.
Tips
- This trigger fires once per submission. If the same person submits the form twice, it fires twice.
- If you need to trigger on all new records regardless of source (manual entry, API, form), use When record created instead.
- You can have multiple automations watching the same form. For example, one automation sends a confirmation email while another creates a linked task.
- Form views respect field visibility settings. Only fields visible in the form are filled by the submission — hidden fields keep their defaults or remain empty.
Related
- When record created — fires on any new record, not just form submissions
- When button clicked — fires when a user clicks a button field in an existing row
- Send email action — commonly paired with form submissions for confirmations

