> ## Documentation Index
> Fetch the complete documentation index at: https://docs.practicemate.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# Create your first Automation

> Build a Birthday Card Email Automation using a Recipe, an Email Template, and the Automation editor.

In this guide, you will build a simple Automation for:

**Sending a birthday Email to patients whose birthday is today.**

This is a friendly first example because it uses the three main pieces of PracticeMate Communications work:

* a Recipe to find the Patient Cohort
* an Email Template to hold the wording
* an Automation to bring them together

## Before you start

You need:

* a Recipe named **Patients whose birthday is today**
* an Email Template named **Birthday email**

If your practice uses different names, choose the matching Recipe and Template from your own list.

<Warning>
  Do not use **Run Now** until your team is ready for the Automation to contact
  patients. Build, save, and review the Automation first.
</Warning>

## Open a new Automation

Open **Automations**, then select **Create Automation**.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/automations-list.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=bff7465c84e44f0766d5e3aa34b27125" alt="The Automations page with the Create Automation button available above the Automations table." className="rounded-lg border" width="880" height="949" data-path="images/automations/automations-list.jpg" />

PracticeMate opens a blank Automation editor.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/new-automation-start.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=468a7f1308d36f713d1b9a2240526c92" alt="A blank new Automation editor showing Automation details, When, Starting from, Then do, and Save Automation." className="rounded-lg border" width="880" height="949" data-path="images/automations/new-automation-start.jpg" />

## Name the Automation

In **Automation details**, enter:

* **Name**: Birthday Card Email
* **Description**: Sends patients an email on their birthday.

The name and description are for your practice team. Patients do not see them.

<Tip>
  Use a name that describes the workflow clearly. **Birthday Card Email** is
  easier to recognise later than **Birthday automation** or **Test email**.
</Tip>

## Choose when it runs

Leave **When** set to **Manual** while you build the Automation.

Manual means PracticeMate will not run this Automation automatically. It will only run when a Member chooses **Run Now**.

If your practice is ready for this to happen automatically every day, choose **Scheduled** instead, then set the Timezone, Frequency, and Time.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/scheduled-trigger-controls.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=1a556307a6f3f93c88f7927b0d7d0460" alt="The When section with Scheduled selected, showing Timezone, Daily Weekly Monthly frequency options, Time controls, and the schedule summary." className="rounded-lg border" width="880" height="949" data-path="images/automations/scheduled-trigger-controls.jpg" />

For a birthday workflow, a daily morning schedule is usually the natural choice once the team is ready.

## Add the Recipe Source

In **Starting from**, select **Add Data Source**.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/select-data-source-dialog.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=5859befeaa9fdcb0e3d97e65a8347835" alt="The Select Data Source dialog showing Run Recipe as the available data source." className="rounded-lg border" width="880" height="949" data-path="images/automations/select-data-source-dialog.jpg" />

Choose **Run Recipe**.

PracticeMate adds a **Run Recipe** card to the **Starting from** section.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/recipe-source-empty.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=7a0157d9e51592201a7c1b318429e1d0" alt="The Starting from section with a Run Recipe card and an empty Using Recipe selector." className="rounded-lg border" width="880" height="949" data-path="images/automations/recipe-source-empty.jpg" />

## Select the birthday Recipe

Open **Using Recipe**.

Choose **Patients whose birthday is today**.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/choose-recipe-menu.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=8b0c97403ee3209e116c6d8fbcf4510b" alt="The Using Recipe menu showing available Recipes, including Patients whose birthday is today." className="rounded-lg border" width="880" height="949" data-path="images/automations/choose-recipe-menu.jpg" />

After you choose the Recipe, PracticeMate shows an expected patient count based on the last time that Recipe was run.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/recipe-source-selected.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=01c7333bcac7f371f8ae4c28b3ccf141" alt="The Run Recipe source selected with Patients whose birthday is today and an expected patient count notice." className="rounded-lg border" width="880" height="949" data-path="images/automations/recipe-source-selected.jpg" />

<Note>
  The expected count is a guide. It helps you check whether the selected Recipe
  looks sensible before the Automation runs.
</Note>

## Add the Email step

In **Then do**, select **Add First Step**.

PracticeMate shows the available Automation Steps.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/add-step-dialog.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=6cfad4da36b0336a0fd910231e978c99" alt="The Add Step dialog showing Clinical Review, Create Report, Send Email, Send SMS, and Wait." className="rounded-lg border" width="880" height="949" data-path="images/automations/add-step-dialog.jpg" />

Choose **Send Email**.

PracticeMate adds a **Send Email** step.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/email-step-empty.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=5268a291092f02e1feb760d7a85a67fb" alt="The Then do section with a Send Email step and an empty Using Template selector." className="rounded-lg border" width="880" height="949" data-path="images/automations/email-step-empty.jpg" />

## Select the Birthday email Template

Open **Using Template**.

Choose **Birthday email**.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/choose-email-template-menu.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=1b8cd45bde6eb347a25f7c56de959ca6" alt="The Using Template menu showing Birthday email and other Email Templates." className="rounded-lg border" width="880" height="949" data-path="images/automations/choose-email-template-menu.jpg" />

The **Send Email** step now uses the Birthday email Template.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/email-step-selected.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=96bf01b428a4325d497c807ceebc6d8d" alt="The Birthday Card Email Automation with Patients whose birthday is today selected as the Recipe Source and Birthday email selected for the Send Email step." className="rounded-lg border" width="880" height="949" data-path="images/automations/email-step-selected.jpg" />

## Review the complete Automation

The complete Automation should read like this:

* **When**: Manual while building, or Scheduled when your team is ready
* **Starting from**: Run Recipe using **Patients whose birthday is today**
* **Then do**: Send Email using **Birthday email**

Your editor should look similar to this finished example.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/birthday-card-email-editor.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=4cea9362b2c6cfda62a351a53ed02e89" alt="The completed Birthday Card Email Automation showing details, Manual trigger, Patients whose birthday is today Recipe Source, and Send Email using Birthday email." className="rounded-lg border" width="880" height="949" data-path="images/automations/birthday-card-email-editor.jpg" />

## Save the Automation

Select **Save Automation**.

PracticeMate checks that the Automation has:

* a valid name
* a data source
* at least one Automation Step
* required selections inside each step

Saving also locks the selected Recipe Version and Email Template Version into the Automation.

<Info>
  Later edits to the Recipe or Birthday email Template will not quietly change
  this Automation. If you want the Automation to use a newer Recipe or Template
  version later, open the Automation and choose **Update to latest** when that
  option appears.
</Info>

## Check the Settings tab

After saving, open **Settings**.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/automation-settings.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=7ce84814a25f5e1467abcb0b61608a6e" alt="The Automation Settings page showing Processing Rules, Prevent reprocessing, Credit Limit, and Communication Limit." className="rounded-lg border" width="880" height="949" data-path="images/automations/automation-settings.jpg" />

For a birthday Email, **Prevent reprocessing** is usually helpful. It stops PracticeMate from sending again to patients this Automation has already processed for the same Recipe.

You can also check the Credit Limit before running the Automation.

## Check the Runs tab

Open **Runs** when you want to see Automation Run history.

For this walkthrough, the Birthday Card Email Automation may not have previous runs yet.

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/automation-runs.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=874520ee633eb296a848de6c6127f34a" alt="The Runs tab for an Automation with no runs yet, showing Run history, No runs yet, overview cards, and Run Now." className="rounded-lg border" width="880" height="949" data-path="images/automations/automation-runs.jpg" />

A populated Runs page looks like this example:

<img src="https://mintcdn.com/practicemate-6786ac90/F4JcWJuIWQtBiLoF/images/automations/automation-run-details.jpg?fit=max&auto=format&n=F4JcWJuIWQtBiLoF&q=85&s=9009beb6bf74cb15eb89b542318fb591" alt="A populated Automation Runs page showing a selected run with status, total patients, credits used, timing, and step activity." className="rounded-lg border" width="880" height="949" data-path="images/automations/automation-run-details.jpg" />

The Runs page helps your practice see what happened each time the Automation ran.

## What you learned

You used:

* **Automation details** to name and describe the workflow
* **When** to choose Manual or Scheduled
* **Starting from** to select a Recipe Source
* **Then do** to add a Send Email step
* **Using Template** to choose the Birthday email Template
* **Save Automation** to store the workflow
* **Settings** to review processing and limit controls
* **Runs** to review previous Automation Runs

<Check>You have built your first PracticeMate Automation.</Check>

Next, use the [Automation editor reference](/automations/editor-reference) when you want a complete guide to every control and available step.
