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

# Add, update or delete Spott records from an automation

> Keep Spott up to date from your HireData automations: add notes, update candidates and other records, or delete them, and check every change before it's saved.

Your automations can now write back to Spott. Log a note after a WhatsApp conversation, move an application to the next stage when a candidate answers a form, or keep a candidate's contact details up to date, without anyone retyping it in Spott.

## Step 1: Add a Spott step

In your automation, click **+** and pick the Spott step you need. There's one step per action and Spott object, such as **Add Note in Spott**, **Update Candidate in Spott** or **Delete Note in Spott**.

Under **What do you want to add?** you can switch to another Spott object at any time.

![The Add Note in Spott step with Note selected, the Record and Settings tabs, and the Title and Content fields](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/add-note-step.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=6ca341600551dd9696fd4466eeaf7fa9)

## Step 2: Pick the record to change

For an update or a delete, tell HireData which Spott record to change:

* **By ID**, for example the candidate who started the automation.
* **With conditions** that find the record, for example the candidate with a given email address.

Then choose what happens when the record can't be found:

* **Fail the step:** nothing changes and the step fails. This is the default.
* **Skip the step:** nothing changes and the automation goes on.
* **Add it instead:** adds a new record with these values.

![The If not found menu with Fail the step, Skip the step and Add it instead](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/if-not-found.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=145311c1ad6ae812b94ea54faf56d719)

When your conditions find more than one record, choose **Use all**, **Use the first** or **Fail the step**.

![The If several match menu with Use all, Use the first and Fail the step](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/if-several-match.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=86bbca65e241970d8424f2377990be19)

## Step 3: Fill in the fields

Type a value or pick a field from earlier in the automation, such as a form answer. Fields you don't touch show **Unchanged** and stay as they are in Spott. Click **Change** to set a new value, or clear the field.

For lists, such as a candidate's email addresses, you can add an item, replace the whole list or remove matching items.

A few things HireData handles for you:

* **Answers are matched to Spott's choices** by name or value, so a form answer such as "yes" or a stage name lands on the right option.
* **Numbers and dates** are read the way your workspace writes them.
* **New applications and jobs** can be placed on a specific pipeline track, and an application on a sub-stage.
* **A value that can't be read** stops the step and shows which value it was, instead of emptying the field in Spott.

![The fields of an Update Candidate step: First name filled in, the other fields marked Unchanged with a Change button](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/update-fields.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=22dee95ae92fa1936e5df9daf2c137a1)

> [!TIP]
>
> An update only changes the fields you set. If nothing would change, the step is skipped instead of saving the same values again, and the run says why.

## Step 4: Preview before you save

Click **Preview**, search for a sample record by name and click **Run preview**. You see exactly what would be added or changed. Nothing is saved to Spott.

![The Preview window: a sample candidate on the left, and on the right the note that would be added with its title and content](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/write-preview.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=c83520d38836cca6841698020118f4de)

## Step 5: Check what was saved

Open a run and click the Spott step. You see which record was changed, each changed field with its old and new value, and **Open in Spott** to go straight to the record.

When something goes wrong, the run explains it in plain words, such as **Record not found**.

![A completed Update Candidate in Spott step with the candidate, an Open in Spott button and the added email address under Changes](https://mintcdn.com/hiredata/einZo2FXg5636qp8/images/apps/spott/write-run-result.png?fit=max\&auto=format\&n=einZo2FXg5636qp8\&q=85\&s=f376f5deac48509ae66224b87bfc5c40)

## What you can't do yet

* **Jobs** can't be deleted, because Spott doesn't allow it.
* **Placements** can be updated, but not added or deleted.

## Related

* [Create a Spott automation](https://help.hiredata.com/apps/spott/create-a-spott-automation-in-hiredata.md)
* [Test an automation](https://help.hiredata.com/automations/how-to-test-an-automation.md)


## Related topics

- [Spott integration overview](https://help.hiredata.com/apps/spott/overview.md)
- [Change Carerix Records From an Automation](https://help.hiredata.com/beta/carerix-records.md)
- [Manage HireData People From an Automation](https://help.hiredata.com/beta/hiredata-people.md)
- [Add](https://help.hiredata.com/reference/automations/steps/add.md)
- [Update](https://help.hiredata.com/reference/automations/steps/update.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.