# Email Integration

Route alerts into Squadcast using Email endpoints of Services from platforms that support Email integrations.

### In Squadcast: Using Email as an Alert Source

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources.png?alt=media\&token=aaca6610-9d18-4dd4-9cf5-320042f326f1)

2\. Select **Email**. Copy the displayed **Webhook URL** to [configure](#how-to-configure-the-email-prefix-for-a-new-service) it within **Email**. Finish by clicking **Add Alert Source** -> **Done**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-5e77d7ef4a02055e7ad625fa0b352388a38aa643%2FEmail.png?alt=media\&token=e490ac58-32f8-487d-a9de-cd9c37029797)

{% hint style="warning" %}
**Important:**

When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### In the external platform which you are using: Configure the Email endpoint

Head over to the platform from where you want to route alerts into Squadcast. Navigate to the section where you can *configure the Email endpoint/integration*. Then, paste the copied Email address in the right placeholder and test this integration, if there is a provision to do so, and validate that the integration works.

That's it, your Email integration is now good to go!

{% hint style="info" %}
**Note**

* The Incident Message will be the subject of the Email and the Incident Description will contain the body of the Email
* Each email alert source is associated with a single, unique email endpoint. Emails can only be sent to one endpoint address at a time.
  {% endhint %}

### How-to: Configure the Email Prefix for a new Service

**(1)** On the **Sidebar**, click on **Services**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-e5afcae4f3af5412602420c93ce82323f39f6c02%2Fintegration_1-1.png?alt=media\&token=542a2f23-b3e0-4571-8320-5424e1432498)

**(2)** Select **Add service**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-ed2bf557db1e3703c4a8e6163365f3f8bf8b1182%2Fintegration_1-2.png?alt=media\&token=281a027a-4540-470b-b25a-4b90276c0b10)

**(3)** Add the details in the box as required along with configuring the **Email Prefix**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-61476ce61eb8110586cfff2ae9a0b5fc5494c7b9%2Femail_2.png?alt=media\&token=2f9f4dd6-c894-46ac-b35d-6927da2613ca)

**(4)** Click on **Save** to create the new Service with an Email Prefix of your choice

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4279f227355cb5a81363aa6d8a8a3fe9b95f2f2b%2Femail_3.png?alt=media\&token=007f81ee-e320-4824-9126-7f8364e48673)

### How-to: Rename the Email Prefix for an existing Service

**(1)** On the **Sidebar**, click on **Services**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-e5afcae4f3af5412602420c93ce82323f39f6c02%2Fintegration_1-1.png?alt=media\&token=542a2f23-b3e0-4571-8320-5424e1432498)

**(2)** For the Service for which you want to rename the Email prefix, click on the **Edit** option

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-b4ab9a260d3411f7bd11069a962f488cc149f898%2Femail_4.png?alt=media\&token=84a836e3-6899-4e60-94d7-d60aa05b4c63)

**(3)** Select **Edit** in the drop-down

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-2914601596539e2335b75348ef1f239609dd4bfa%2Femail_5.png?alt=media\&token=b481ad2e-ebfb-43fd-99c5-453b45798687)

**(4)** Replace the existing prefix with the prefix of your choice in the placeholder for **Email Prefix**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-06e5da393acf1fe5b37ade2279018f35098ab596%2Femail_6.png?alt=media\&token=22c6b525-4fce-40ed-9d1b-937845c542e5)

**(5)** Click on **Save**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-488948ae6d2646f5afd4d6acb99883474c2dd80c%2Femail_7.png?alt=media\&token=e624c45d-5f6a-4a20-a546-b741f10d5d60)

Now, whenever an Email is sent to the Service's Email address, Squadcast will trigger an incident for it.

{% hint style="info" %}
**Note**

This integration does not support **auto-resolution** of incidents. If the platform you are using resolves an alert, you will have to manually resolve the corresponding incident in Squadcast via the [<mark style="color:blue;">web app</mark>](https://www.app.squadcast.com) or the [<mark style="color:blue;">Squadcast mobile app</mark>](https://support.squadcast.com/mobile-app/using-the-mobile-app)<mark style="color:blue;">.</mark>
{% endhint %}

{% hint style="warning" %}
**Important**

* If you are sending regular emails - emails in the `text/html` format, URLs for images will appear as URLs only. If the image is added inline, only the name of the file will appear and not the image. However, please note that if the image is added as an attachment, it will not show up in the payload (and hence, the Incident Description).
* If you are sending emails as plain text - emails in the `text/plain` format, you can add images using the Markdown syntax `![image_name](image_url)`. The link of the image will appear in the Incident Description. Similarly, you will also be able to format the body content using Markdown, and the content with the same formatting will be displayed in the Incident Description.
  {% endhint %}

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.squadcast.com/integrations/alert-source-integrations-native/email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
