---
title: Email
description: You can use the IDM outbound email service over REST at the external/email endpoint:
component: pingoneaic-api
page_id: pingoneaic-api:idm-rest-api:endpoints/rest-email
canonical_url: https://developer.pingidentity.com/pingoneaic-api/idm-rest-api/endpoints/rest-email.html
section_ids:
  externalemail-post-parameters: external/email POST parameters
---

# Email

|   |                                                                                                                                            |
| - | ------------------------------------------------------------------------------------------------------------------------------------------ |
|   | Learn how to configure the email service in [Email provider](https://docs.pingidentity.com/pingoneaic/latest/tenants/email-provider.html). |

You can use the IDM outbound email service over REST at the `external/email` endpoint:

| URI                                           | HTTP Operation | Description              |
| --------------------------------------------- | -------------- | ------------------------ |
| /openidm/external/email?\_action=send         | POST           | Sends an email.          |
| /openidm/external/email?\_action=sendTemplate | POST           | Sends an email template. |

Find additional examples in [Send mail](https://docs.pingidentity.com/pingoneaic/latest/tenants/email-send.html).

## `external/email` POST parameters

Advanced Identity Cloud supports the following POST parameters:

* `from`

  Sender mail address

* `to`

  Comma-separated list of recipient mail addresses

* `cc`

  Optional comma-separated list of copy recipient mail addresses

* `bcc`

  Optional comma-separated list of blind copy recipient mail addresses

* `subject`

  Email subject

* `body`

  Email body text

* `_locale`

  Takes precedence over `defaultLocale` but not `preferredLocales` specified in the `Accept-Language` header. If no preferred locales are set, uses the specified locale ([ISO 639-1 language codes](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes)).

* `type`

  Optional MIME type. One of `"text/plain"`, `"text/html"`, or `"text/xml"`.