---
description: Configure email providers for sending notifications and alerts from Aidbox applications.
---

# Email providers integration

Aidbox supports sending emails through using `Notification`, `NotificationTemplate`.

It is possible to setup any SMTP provider using Aidbox settings, also there's separate integration for [Postmark](../../../tutorials/integration-toolkit-tutorials/postmark-integration-tutorial.md)\
and [Mailgun](../../../tutorials/integration-toolkit-tutorials/postmark-integration-tutorial.md).

## Sending email

The email can be sent using `POST /Notification/<notification-id>/$send`request.

## Setup SMTP provider

Explained in the following page:

{% content-ref url="setup-smtp-provider.md" %}
[setup-smtp-provider.md](setup-smtp-provider.md)
{% endcontent-ref %}

## Notification resource

The Notification resource is used to send notifications using a specified provider. Simplest notification can be created like this:

```http
PUT /Notification/notification-1

provider: '<yourProviderId>'
providerData:
  to: recipient@example.com
  subject: my subject
  body: hello
```

It is also possible to create a predefined notification template. The resource supports dynamic content by including a payload that is merged into the template.

```http
PUT /Notification/notification-1

provider: '<yourProviderId>'
providerData:
  to: recipient@example.com
  subject: My subject of the message
  template:
    id: notification-template-1
    resourceType: NotificationTemplate
  payload:
    foo:
      bar: zaz
```

## NotificationTemplate resource

The NotificationTemplate resource is used to store and manage the body of email messages. This allows for templated messages to be dynamically generated using placeholders that can be replaced with actual values at runtime.

NotificationTemplate example:

```http
PUT /NotificationTemplate/notification-template-1

# foo.bar value is placed in the Notification.providerData.payload object
template: <b>Hello world! {{foo.bar}}</b>
```

## Sending the email

Use `$send` endpoint:

```http
POST /Notification/notification-1/$send
```

## See also

{% content-ref url="../../../reference/email-providers-reference/" %}
[email-providers-reference](../../../reference/email-providers-reference/)
{% endcontent-ref %}