# Create your first workflow

> Build a workflow that emails the customer when a job is created and then updates the job, turn it on and check that it ran.

Source: https://tadabase.com/docs/workflows/creating-your-first-workflow  
Status: Verified Nov 17, 2026. Checked against the current product

This walkthrough builds a workflow on the Jobs table: when a job is created, it emails the customer and then sets the job's status. It takes about five minutes and shows every part of the editor you will use again.

> **Note:** You need a Jobs table with a customer email field (or a connection to a customer record that has one) and a status field. Use your own table names if they differ.

## Create the workflow and choose its trigger

1. **Open Workflows** In the builder, click the **Workflows** icon in the left-hand bar.
2. **Start a new workflow** Click **New Workflow** at the top right (in an app with no workflows yet, click **Create workflow**). The editor opens with a **Trigger** card that says **Choose a trigger**, and the settings panel on the right.
3. **Pick the trigger** Under **Trigger Type**, open the list and choose **Record Created** in the **Records** group.
4. **Pick the table** Under **Data Source**, set **Table** to **Jobs**. You pick the trigger first and the table second: the **Table** setting only appears for triggers that need one.
5. **Name it** Tadabase fills in a name from the trigger and table. To change it, click the pencil next to the name at the top left, type a new name such as "Job created: email customer" and click **Save**.

![The workflow editor with the Trigger card selected and the settings panel showing Trigger Type set to Record Created and Table set to Jobs](https://tadabase.com/docs-shots/workflows-editor-trigger.webp)

## Add the email step

1. **Add a step** Click **Add First Step** under the trigger card. The panel shows **Choose Step Type**.
2. **Choose an action** Click **Add Action**. The actions are grouped: **Data Management**, **Communication**, **Documents**, **Utilities** and **User Experience**. You can also type in **Search actions...**.
3. **Pick Send Email** Open **Communication** and click **Send Email**.
4. **Fill in the email** Under **Email source**, pick an email template or build a custom email. Fill in **Subject**, then under **Send To** choose the customer's email from the record. Write the **Content**. Fields marked * are required.

![The Add Action panel with the action groups Data Management, Communication, Documents, Utilities and User Experience and a search box above them](https://tadabase.com/docs-shots/workflows-first-action-picker.webp)

## Add a second step to update the job

1. **Add another step** Click **Add Step** under the email step, then **Add Action**.
2. **Pick Update Record** Open **Data Management** and click **Update Record**.
3. **Choose the record** Set **Record to update** to **Source Record**: the job that started the run.
4. **Set the value** Under **Set field values**, choose your status field and set it to a value such as "Customer notified".

Steps run from top to bottom, so the status changes only after the email step has run. For the other ways to fill in a value, see [Create, update and copy records in a workflow](https://tadabase.com/docs/workflows/data-actions).

## Save and turn it on

1. **Switch it to Active** At the top right, switch the status from **Inactive** to **Active**. New workflows start as Inactive and do not run until you switch them on.
2. **Save** Click **Save** at the bottom right. If the button is greyed out, the editor shows **Complete required fields to save.**: open the steps marked with an error and fill in the missing fields.

> **Note:** A workflow with no steps still runs when it is triggered, but each run is recorded as Skipped.

## Test it

1. **Create a job** Add a record to the Jobs table, from a form in your app or in the Data Builder.
2. **Watch the run** In the workflow editor, click **Running** to see runs that are queued or in progress.
3. **Check the result** Click **History**. Each run shows its status and what every step did. Open a run to see the email that was sent and the field that was updated, or the error if a step failed.

> **Note:** Workflows with the **Schedule** trigger also have a **Run** button with a **Dry run** option, which walks through the steps without changing or sending anything. Record-triggered workflows are tested by creating or editing a record.

## Next steps

- Only email some customers: add a condition before the email. See [Conditions and branches](https://tadabase.com/docs/workflows/conditions-and-branches).
- Use values from earlier steps: see [Using workflow data](https://tadabase.com/docs/workflows/using-workflow-data).
- Explore the other actions: see [Workflow actions at a glance](https://tadabase.com/docs/workflows/workflow-actions-overview).
