---
updatedAt: 2026-03-01T18:53:46.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/mfa/llms.txt
---

# Send enrollment email

```curl cURL
egcurl --eg-section default --request POST \
  --url "https://$hostname/amfa/v1/email-enrollments" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '
{
    "userIds": [
        "user_5JmO0b2SZMrc72a2C8A25R"
    ]
}'
```

```javascript Node
const EdgeGrid = require("akamai-edgegrid");
const os = require("os");
const edgercPath = os.homedir + "/.edgerc.txt";
const edgercSection = "default";
const eg = new EdgeGrid({
  path: edgercPath,
  section: edgercSection,
});

eg.auth({
  path: `/amfa/v1/email-enrollments`,
  method: "POST",
  headers: {
    "Content-Type": "application/json",

    Accept: "application/json",
  },
  body: {
    userIds: ["user_5JmO0b2SZMrc72a2C8A25R"],
  },
});
eg.send(function (error, response, body) {
  console.log(JSON.stringify(JSON.parse(body), null, 2));
});

```

```python Python
import requests
import json
from akamai.edgegrid import EdgeGridAuth, EdgeRc
from urllib.parse import urljoin

edgerc = EdgeRc('~/.edgerc.txt')
section = 'default'
baseurl = 'https://%s' % edgerc.get(section, 'host')

session = requests.Session()
session.auth = EdgeGridAuth.from_edgerc(edgerc, section)
 

path = '/amfa/v1/email-enrollments'
headers = {
  "Content-Type": "application/json",

  "Accept": "application/json"}
payload = {
    "userIds": [
        "user_5JmO0b2SZMrc72a2C8A25R"
    ]
}  

result = session.post(urljoin(baseurl, path), headers=headers, json=payload)
print(result.status_code)
print(json.dumps(result.json(), indent=2)) 
```

```json Response Example
{
  "userIds": [
    "user_5JmO0b2SZMrc72a2C8A25R"
  ]
}
```

# Set up authentication

<!-- curl@1 -->
<!-- javascript@1-8 -->
<!-- python@1-11 -->

Before you can use this API, you need to [Create authentication credentials](https://techdocs.akamai.com/developer/docs/set-up-authentication-credentials).

Then, you can include this code to apply the token values to validate your requests.

Refer to [EdgeGrid libraries](https://techdocs.akamai.com/developer/docs/authenticate-with-edgegrid#edgegrid-libraries) to install the necessary modules for various programming languages.

# Form the request URL

<!-- curl@2 -->
<!-- javascript@11 -->
<!-- python@14 -->

Specify the target endpoint.

# Build the body request object

<!-- curl@7-9 -->
<!-- javascript@18-20 -->
<!-- python@19-23 -->

Add a set of `userIds` to send enrollment emails to.

If you need these values, run [List users](https://techdocs.akamai.com/mfa/reference/get-users).

# Call the API

<!-- curl@1-10 -->
<!-- javascript@1-25 -->
<!-- python@1-27 -->

Call POST on the request URL, providing the body request object.

# View the response



The response returns an array with a set of `userIds` that received enrollment emails.