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

# Email notifications

> Connect your email account once, then get an email whenever someone sends one of your forms.

Get an email every time someone sends one of your forms, and send visitors a confirmation too. Connect your email account to Fetchski Attract once to turn this on. Until you do, submissions are still saved, but no email goes out.

 **Who can do this:** Admins and Owners connect email and send the test. Anyone who can edit a form chooses who gets its emails.

## Before you start

* You need an account with an email sending service: SendGrid, Postmark, or any service that gives you an SMTP server. This is a service that sends email for websites. It's separate from the inbox you read your email in.
* Verify your sending domain with that service, such as `parkerspuppyplayland.example`. Services send email only from an address on a verified domain.
* Get the login the service gives you for sending: an API key (SendGrid), a server token (Postmark) or an SMTP username and password. **Setup guide — email provider** on the Email card shows where to find it for your service.

## Connect your email account

**1. Open Connections**

In the toolbar, choose **Connections**. Or open the command palette (⌘K, or Ctrl+K on Windows) and choose **Connections** (T then E).

**2. Open the Email card**

Under **Essentials**, choose **Email**. Its badge says **Not set up** until it's ready.

![Connections open on the Email card with SendGrid chosen: Setup guide — email provider, API key / server token (filled, shown as dots), From name "Parker's Puppy Playland".](https://mintcdn.com/fetchski-attract-api/VHp0B0s1nBbMi7JQ/images/cms/guides/forms/email-notifications/guides-forms-email-notifications-card-light.png?fit=max\&auto=format\&n=VHp0B0s1nBbMi7JQ\&q=85\&s=492d433aaa764a3057bec981c64995eb)

The Email card with SendGrid chosen.

**3. Choose your service**

In **Email provider**, choose **SendGrid**, **Postmark** or **Other SMTP server**. **Off (no outgoing email)** is the starting choice.

**4. Follow the guide**

Open **Setup guide — email provider** for step-by-step help for your service.

**5. Enter your login**

* **SendGrid**: paste an API key with **Mail Send** access only into **API key / server token**.
* **Postmark**: paste your server's **Server API token** into **API key / server token**.
* **Other SMTP server**: fill in **SMTP host**, **SMTP port**, **SMTP username** and **SMTP password**. Use port 587 for most servers. For port 465, turn on **Encrypted connection from the start (port 465)**.

**6. Say who it's from**

In **From name**, type the name people see, usually your business name. In **From address**, type an address on your verified domain.

**7. Save**

Choose **Save** at the top right. Your key is now stored safely. From now on it shows as dots, with **Replace** and **Remove**.

**Advanced options** on the card holds **Default Reply-To (optional)**: where replies go when an email names no one else.

With Postmark, it also holds **Postmark message stream**. Leave it as `outbound` unless you made another stream.

## Send a test email

**1. Scroll to Send a test email at the bottom of the Email card**

The box already holds your own address. Change it if you like.

**2. Choose Send test email**

**3. Read the result under the box**

"Sent to …" means it worked. Check that inbox for an email titled "Fetchski CMS test email".

The test uses your saved settings, so choose **Save** first after any change. A test that works also ticks off **Connect email** in [Set up your site](https://docs.fetchski-attract.com/guides/get-started/set-up-your-site.md).

![The Send a test email area with jordan@parkerspuppyplayland.example in the box and a green "Sent to …" result under it.](https://mintcdn.com/fetchski-attract-api/0g3iIRMTmzCPGaat/images/cms/guides/forms/email-notifications/guides-forms-email-notifications-test-light.png?fit=max\&auto=format\&n=0g3iIRMTmzCPGaat\&q=85\&s=ab63929b80437b88fa00c145f3712db0)

A test email that went through.

## Choose who gets each form's emails

Open the form in the **Forms** manager. There are 2 ways to email a submission. Start with the **Actions** tab: it's the simplest.

The 2 ways work separately. If you put the same address in both, that address gets 2 emails for every submission, so use one place per address.

**Actions tab**: the quick way to get a copy of every submission.

**1. On the Actions tab, add an item**

**2. In Action, choose Email a notification**

**3. In Notify address, type where the copy should go, such as `hello@parkerspuppyplayland.example`**

**4. Publish the form**

Each action has an **Enabled** switch, so you can pause its emails without deleting it.

**After submission tab**: more options.

* **Email Address(es) for Results**: one or more addresses that get every submission.
* **Set Conditions for this Notification**: sends to an address only when a visitor gives a certain answer. For example, Parker's sends to `downtown@parkerspuppyplayland.example` only when a visitor chooses "Downtown" in the form's **Location** question. Add the address, then set the condition: the question and the answer that sends to it.
* **Send a confirmation email**: emails the visitor a copy of what they sent. In **Which is your confirmation email field?**, type the short name of the form's email question. On any form made from a template, that's `email`.
* **Primary internal email address**: where a visitor's reply to their confirmation email goes. Its help text calls it the "from" address, but every email is actually sent from the **From address** in Connections. A new form starts with the **Email** from [Site settings → Brand](https://docs.fetchski-attract.com/guides/site-settings/brand.md).

![The Contact Us form's Actions tab with one row: Action "Email a notification", Enabled on, Notify address hello@parkerspuppyplayland.example.](https://mintcdn.com/fetchski-attract-api/VHp0B0s1nBbMi7JQ/images/cms/guides/forms/email-notifications/guides-forms-email-notifications-action-light.png?fit=max\&auto=format\&n=VHp0B0s1nBbMi7JQ\&q=85\&s=96dd3e9645e6e05c023881e5e5399b68)

Email a copy of each submission with one action.

## What happens next

Each new submission is emailed right away.

| Email | Sent from | Sent to | A reply goes to |
| - | - | - | - |
| Notification (a copy of the submission) | Your **From address** in Connections | Each **Notify address** and **Email Address(es) for Results** | The visitor who sent the form |
| Confirmation | Your **From address** in Connections | The visitor | The form's **Primary internal email address** |

Changes in Connections apply from the next email. Changes to a form apply once you publish it.

## Troubleshooting

> [accordion] The provider refused the login. Check the API key, token or SMTP password.
>
> The key, token or password is wrong, expired or missing a permission. For SendGrid, make sure the key has **Mail Send** access. Choose **Replace**, paste a fresh one, choose **Save** and test again.

> [accordion] The provider refused the message. Usually the From address is not a verified sender for this account.
>
> Your **From address** isn't on a domain or sender you verified with your service. Verify it there, or change the **From address** to one that is. Then save and test again.

> [accordion] Could not connect to the email server" or "The SMTP server's host name could not be found.
>
> Check **SMTP host** and **SMTP port** against your service's instructions. Port 465 needs **Encrypted connection from the start (port 465)** turned on. Port 587 needs it off.

> [accordion] Email isn't set up: …
>
> Something the CMS needs is missing. The message names it, for example "Email isn't set up: add a valid From address in Connections → Email." Fill it in, choose **Save** and test again.

> [accordion] Too many test emails. Try again in N minutes.
>
> You can send only a few tests in a short time. Wait the minutes it says, then try again.

> [accordion] The test works, but form emails don't arrive
>
> * Check that the form is published with an email set: an **Email a notification** action that's **Enabled**, or an address in **Email Address(es) for Results**.
> * Check the form's **Primary internal email address**. It starts empty while **Site settings** → **Brand** → **Email** still holds the starting example address. Set your real address there, then fill it in on the form.
> * Look in your spam folder, and in your email service's activity log.
> * The submissions are still saved. See them in [Form submissions](https://docs.fetchski-attract.com/guides/forms/form-submissions.md).

## Related

> [card] [Build a form](https://docs.fetchski-attract.com/guides/forms/build-a-form.md)
>
> create a form and put it on a page.

> [card] [Form submissions](https://docs.fetchski-attract.com/guides/forms/form-submissions.md)
>
> read and export everything your forms collect.

> [card] [Spam protection](https://docs.fetchski-attract.com/guides/forms/spam-protection.md)
>
> keep bots out of your forms.

> [card] [Connections](https://docs.fetchski-attract.com/guides/connections/index.md)
>
> every outside service your site uses.


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