> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/cloud/emails/integrations.md).

# Integrations

Email integrations — the providers that deliver your emails, which one is the default, and whether each one works.

**Where:** Email → Integrations · `/projects/<project>/emails/integrations`

An email integration is the provider that delivers your emails: AWS SES, Twilio SendGrid, Mailgun, any SMTP server, or the built-in Fake provider that delivers nothing. The list **Email Service Integrations** shows every integration of the current environment and which one is the default.

<figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-95ba9a8f1b80b01745a9d7e670b33ad357bab57e%2Fintegrations-list-1.png?alt=media" alt="Email Service Integrations list: Test Me (Fake, DEFAULT), SendGrid (example), Mailgun (example), SES (example), Mailpit (local test, Smtp)"><figcaption><p>Five integrations; the Fake <strong>Test Me</strong> is the default.</p></figcaption></figure>

{% hint style="info" %}
This is the Email version of Integrations. The rules that are the same in every module (environments, the default, integrations in use) are on the [Integrations](/codemash/cloud/concepts/integrations.md) page.
{% endhint %}

## Columns, search and filters

| Column               | What it shows                                                                                                                                  |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Integration Name     | The name; press it to open the integration.                                                                                                    |
| Provider             | `Fake`, `SendGrid`, `MailGun`, `AwsSes` or `Smtp`.                                                                                             |
| Sender Email Address | The "from" address, for example `no-reply@acme.example`.                                                                                       |
| Sender Display Name  | The "from" name, for example `Acme`.                                                                                                           |
| Enabled              | `True` or `False`. A disabled integration is never used.                                                                                       |
| Default              | **DEFAULT** on the integration the campaign form and the trigger actions pre-select (in another environment: **DEFAULT FOR TEST**, and so on). |

When more than one integration is enabled and none of them is the default, the warning **No Default Set For Active Integrations** appears above the list. The list has no filter.

Inside an integration, badges show its state: **DEFAULT**, **ENABLED** / **DISABLED**, **TESTED** / **NOT TESTED**, **CONFIRMED** / **NOT CONFIRMED** (someone pressed **I received it** after a test).

## What you can do here

* [Connect a provider](/codemash/cloud/emails/integrations/providers.md) — **Add New Integration**, then the provider's page
* [Test an integration](/codemash/cloud/emails/integrations/test.md) — send a real test email, confirm it arrived, check the sender domain
* [Set as default](/codemash/cloud/emails/integrations/set-default.md) — the integration new campaigns and triggers pre-select
* [Disable or delete](/codemash/cloud/emails/integrations/disable.md) — stop using it, or remove it
* [Validation integrations](/codemash/cloud/emails/integrations/validation.md) — address-checking services (no screen; API only)

## Do it from code

```ts
const { list, defaultIntegrationId } = await norbix.hub.notifications.getEmailIntegrations();
console.log(defaultIntegrationId, list.items.map((i) => `${i.viewId} ${i.emailProvider} ${i.integrationName}`));
// int_6TG84uqtIL4HghyUx0EONk [ 'int_6TG84uqtIL4HghyUx0EONk Fake Test Me', 'int_EHCfsQqCmMCrhLzxdrX3u MailGun Mailgun (example)', … ]
```

```sh
norbix hub notifications email integrations get
```

API: [Get Email Integrations](/codemash/api-reference/notifications/email/get-email-integrations.md) · [Get Email Integration](/codemash/api-reference/notifications/email/get-email-integration.md)