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

# Email

|   |                                                                                          |
| - | ---------------------------------------------------------------------------------------- |
|   | To configure the email service, see [Email provider](../../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. |

For additional examples, refer to [Send mail](../../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"`.