---
title: "Sends a single email using AWS SES service with specified parameters."
method: POST
path: "/sendEmail"
---

# Sends a single email using AWS SES service with specified parameters.

`POST /sendEmail`

This function sends an email to a specified recipient using AWS SES (Simple Email Service). It allows for customization of sender, recipient, subject, and body content in both plain text and HTML formats. The function returns a promise that resolves to a SendEmailResponse object containing the message ID and request metadata.

## Request body

- object
  - `body` object — Body of the sendEmail sls call
    - `arguments` unknown[], required
      - unknown
    - `auth` object — Authentication object
      - `strategy` 'apikey' — Authentication strategy
      - `variables` unknown[] — Variables for the authentication strategy
        - unknown
    - `packageName` string — @microfox/aws-ses

## Response `200`

Email sent successfully

- object
  - `SendEmailResult` object
    - `MessageId` string — The unique identifier for the sent email
  - `ResponseMetadata` object
    - `RequestId` string — The unique request identifier

## Other responses

- `400` — Bad Request - Invalid parameters
- `500` — Internal Server Error

## Changes

- **2025-05-27** `e2e5cbb7c6db` — 6 warning, 3 info
  - removed the request property `bodyHtml`
  - removed the request property `bodyText`
  - removed the request property `displayName`
  - removed the request property `recipient`
  - …5 more
- **2025-05-16** `e9e8a90e40e0` — 5 breaking, 1 warning, 3 info
  - added the new required request property `recipient`
  - added the new required request property `sender`
  - added the new required request property `subject`
  - removed the media type `application/json` for the response with the status `400`
  - …5 more

[Change history](https://skmtc.dev/microfox-ai/apis/microfox-aws-ses-api/changes/sendEmail/post.md)

---

[API](https://skmtc.dev/microfox-ai/apis/microfox-aws-ses-api.md) · [All operations](https://skmtc.dev/microfox-ai/apis/microfox-aws-ses-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microfox-ai/microfox-aws-ses-api/revisions/132031a65b75/schema)