# Automate a form

Turn each response into a person, a company or a deal, assign it, forward it by email, and do different things for different answers.

A form's automation runs once for every response, as it arrives. Use it to add the people who write in to your contacts, link them to their company, open a deal for each enquiry, hand the response to the right person and forward it by email.

## Before you start

<ul class="accent-bullets"><li><p>Automations are part of the Orbit and Landing plans. On Launch, you can see the tab but not add an automation. The <strong>Newsletter sign-up</strong> form's own automation is the exception: it runs on every plan.</p></li><li><p>You need to be able to change the form. Only those people see its <strong>Automations</strong> tab. See <a href="../marketing/who-can-see-a-form.md" target="_blank" rel="noopener noreferrer" class="cursor-pointer box-border border-b transition-all duration-75 " style="text-decoration: none; border-color: var(--portal-accent-color);">Who can see a form</a>.</p></li><li><p>Each step reads its details from the form's fields, so add the fields first: an <strong>Email</strong> field for a person, and a <strong>Text</strong> field for a name or a company.</p></li><li><p>The <strong>Contact</strong> form your organisation is given to start from comes with an automation, <strong>New Contact</strong>, which finds or creates the person and their company. Select it to see how it's built, or to change it.</p></li></ul>

## Create the automation

A form has one automation, which holds every step you want to run.

<ol class="steps-list"><li><p>Open the form and choose the <strong>Automations</strong> tab.</p></li><li><p>Choose <strong>Add automation</strong>.</p></li><li><p>Give it a <strong>Name</strong>, for example "Add enquiries to contacts". <strong>Switched on</strong> is on to start with.</p></li><li><p>Choose <strong>Add a step</strong>, pick what should happen, and fill in its settings.</p></li><li><p>Add more steps, up to 10.</p></li><li><p>Choose <strong>Create automation</strong>.</p></li></ol>

There's nothing to choose for what sets it off. Every response to the form does.

Once the form has its automation, **Add automation** is no longer shown. Select the automation to add, change or remove its steps, then choose **Save automation**.

## Steps you can add

| Step | What it does |
| --- | --- |
| **Assign the response** | Gives the response to a member, who is notified. |
| **Find or create the person** | Looks for a person in your contacts with the email address given. If there isn't one, it adds them. |
| **Find or create the company** | Looks for a company in your contacts with the name given. If there isn't one, it adds it. |
| **Create a deal** | Creates a deal in the stage you choose. |
| **Forward by email** | Emails the whole response to an address. |
| **Add to a list** | Puts the person the response was filed with on one of your own lists. |
| **Remove from a list** | Takes that person off one of your own lists. |
| **If / else** | Runs different steps depending on what was answered. |

The person, company and deal steps file the response with what they found or created. Each shows as a chip on the response in the inbox, and the response shows on that record's **Inbox** tab.

### Assign the response

<ul class="accent-bullets"><li><p><strong>Assign the response to</strong>: the member who should have it. They need to be on the form.</p></li></ul>

They're notified, and the response shows as theirs in the inbox.

### Find or create the person

<ul class="accent-bullets"><li><p><strong>Their email address is in</strong>: the <strong>Email</strong> field that holds their address.</p></li><li><p><strong>Their full name, or first name, is in</strong>: a <strong>Text</strong> or <strong>Email</strong> field, if you like. Without one, they're named after their email address.</p></li><li><p><strong>Their last name is in</strong>: a <strong>Text</strong> or <strong>Email</strong> field. Use it only if your form asks for first and last names separately.</p></li><li><p><strong>Their phone number is in</strong>: a <strong>Phone</strong> field, if you like. The number is saved when it's an international one, like +44 1632 960000.</p></li><li><p><strong>Opt them in to marketing</strong>: a switch, off to start with. When it's on, someone who agrees to your privacy policy on the form is opted in to marketing, including someone already in your contacts. It needs the form's privacy policy agreement switched on in its <strong>Settings</strong>, and a privacy policy set in your organisation's brand settings, so the switch is on the form. Nobody is opted out by it. A live form can't have this on without both, and you're told which is missing when you save. To email each person a link to confirm first, see <a href="../marketing/collect-newsletter-sign-ups.md" target="_blank" rel="noopener noreferrer" class="cursor-pointer box-border border-b transition-all duration-75 " style="text-decoration: none; border-color: var(--portal-accent-color);">Collect newsletter sign-ups</a>.</p></li><li><p><strong>Add a new person as</strong>: the lifecycle a new person starts at.</p></li></ul>

When one field holds their whole name, it's split into a first and last name for you:

<ul class="accent-bullets"><li><p>A title at the start is left out: "Mr Test User" is saved as Test User.</p></li><li><p>Their last name keeps the words that belong to it: "Ludwig van Beethoven" is Ludwig and van Beethoven, and "Martin Luther King Jr" is Martin Luther and King Jr.</p></li><li><p>A name written surname first, with a comma, is read that way: "Lovelace, Ada" is Ada Lovelace.</p></li><li><p>One word is their first name, and their last name is saved as "(not given)".</p></li></ul>

If both fields are answered, the names are saved as they were given. If only the last name is, their first name is saved as "(not given)".

### Find or create the company

<ul class="accent-bullets"><li><p><strong>The company's name is in</strong>: the <strong>Text</strong> or <strong>Email</strong> field that holds the company's name.</p></li><li><p><strong>Add a new company as</strong>: the lifecycle a new company starts at.</p></li></ul>

### Create a deal

<ul class="accent-bullets"><li><p><strong>Create the deal in</strong>: the stage the deal starts in. Only open stages are offered.</p></li><li><p><strong>Name the deal after</strong>: a <strong>Text</strong> or <strong>Email</strong> field, if you like. Without one, the deal is named after the form.</p></li><li><p><strong>Assign the deal to</strong>: <strong>Whoever the response is assigned to</strong>, <strong>A specific member</strong> or <strong>Nobody</strong>.</p></li></ul>

### Forward by email

<ul class="accent-bullets"><li><p><strong>Send it to</strong>: the address the response is emailed to, such as a shared mailbox. If your organisation has set up its own email addresses, they are suggested as you click or type. Choose one, or type any other address.</p></li></ul>

The response is still kept in the inbox. Replying to the email replies to whoever sent the response.

The email is sent from your organisation's own address when it has one it can send from. If it has more than one, the address that was set up first is used. Otherwise it is sent from 53°.

## Do different things for different answers

**If / else** checks what the response answered and sends it down one path. It's always the last step, and it needs a **Dropdown**, **Single choice** or **Multiple choice** field on the form.

<ol class="steps-list"><li><p>Choose <strong>Add a step</strong>, then <strong>If / else</strong>.</p></li><li><p>Select the first path. Under <strong>Take this path when</strong>, choose <strong>All of these</strong> or <strong>Any of these</strong>.</p></li><li><p>For each condition, choose the <strong>Field</strong>, a <strong>Comparison</strong> of <strong>Is</strong> or <strong>Is not</strong>, and one or more <strong>Options</strong>. Choose <strong>Add a condition</strong> for another, up to 5.</p></li><li><p>Add the steps that path should run, up to 5.</p></li><li><p>Choose <strong>Add a path</strong> for another set of conditions. An <strong>If / else</strong> step can have up to 4 paths.</p></li><li><p>Add steps under <strong>Otherwise</strong> for a response that matches no path, if you like.</p></li></ol>

A response takes the first path whose conditions its answers meet, and only that path's steps run. A path can run any of the other steps, but not another **If / else**.

For example, to hand out responses by a "Department" dropdown, add a path for each option and put **Assign the response** on each, with a different member. To forward only some responses, put **Forward by email** on a path.

A question left unanswered counts as none of its options, so **Is** doesn't match it and **Is not** does.

## How the steps work together

Whatever order the steps are in, what one automation finds or creates is linked up:

<ul class="accent-bullets"><li><p>The person and the company are linked, so the person shows as working at the company.</p></li><li><p>The deal gets the person and the company as its contacts.</p></li></ul>

One order does matter. For a deal to go to **Whoever the response is assigned to**, put **Assign the response** before **Create a deal**.

## What gets skipped

Nobody is there to fix a problem when a response arrives, so a step that can't run is skipped and the rest carry on.

<ul class="accent-bullets"><li><p>If the field a step reads from wasn't answered, that step is skipped. Make the field <strong>Required</strong> on the form to avoid this.</p></li><li><p>If the member a response should be assigned to has left your organisation, it isn't assigned.</p></li><li><p>If the deal's stage has been deleted or is no longer open, the deal isn't created.</p></li><li><p>If a deal should go to whoever the response is assigned to and nobody is, or the member has left, the deal is still created, with nobody assigned.</p></li><li><p><strong>Add to a list</strong> and <strong>Remove from a list</strong> act on the person a <strong>Find or create the person</strong> step found or added earlier in the same automation. Without one, they're skipped. If the list has been deleted, they're skipped too.</p></li></ul>

Run history shows which steps were skipped and why.

## Turn the automation on or off

Use the switch at the start of its row on the **Automations** tab. Select the automation to edit it, or use the bin icon on its row to delete it. Deleting it removes its run history too.

The **Newsletter sign-up** form's automation can't be deleted, because the form needs it. Switch it off instead.

## Check what ran

Select the automation and open **Run history**. Each run shows how it went, such as **Succeeded**, **Partly ran**, **Skipped** or **Failed**. Choose **Show details** to see each step. Choose **Load more runs** for older ones.

## Good to know

<ul class="accent-bullets"><li><p>Someone already in your contacts is left as they are. An automation finds a person by email address and a company by name, and never edits either.</p></li><li><p>Contacts an automation adds get the source <strong>Form</strong>, so you can filter for them in your contacts.</p></li><li><p>A new person needs a first and last name. A name given in one field is split into the two. If it holds one word, their last name is saved as "(not given)".</p></li><li><p>A phone number that isn't international, starting with +, isn't saved. The person is still added.</p></li><li><p>Whoever a response is assigned to is notified once, even if they were also told when it arrived.</p></li><li><p>A locked response doesn't set off the automation until it's unlocked. See <a href="../marketing/manage-responses-in-the-inbox.md" target="_blank" rel="noopener noreferrer" class="cursor-pointer box-border border-b transition-all duration-75 " style="text-decoration: none; border-color: var(--portal-accent-color);">Manage responses in the inbox</a>.</p></li><li><p>If your plan stops including automations, the one you've built is kept but paused. It starts running again when your plan includes them.</p></li><li><p>Duplicating a form doesn't copy its automation. Deleting a form deletes it.</p></li><li><p>Putting someone on a list can start that list's sequences, but only for someone who can be sent marketing email. See <a href="../marketing/automate-emails-with-sequences.md" target="_blank" rel="noopener noreferrer" class="cursor-pointer box-border border-b transition-all duration-75 " style="text-decoration: none; border-color: var(--portal-accent-color);">Automate emails with sequences</a>.</p></li></ul>
