---
title: "AWS SNS/SES delivery event endpoint"
method: POST
path: "/provider-events/ses"
tags: ["public"]
---

# AWS SNS/SES delivery event endpoint

`POST /provider-events/ses`

## Request

- Base URL: `https://api.mailly.site` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mailly.site/provider-events/ses`
- Auth: none required

Authenticated with a dedicated secret (`x-mailly-provider-secret` header or `?token=`); handles SNS SubscriptionConfirmation and SES delivery and unsubscribe events.

## Query parameters

- `token` string

## Request body

- object: AWS SNS envelope
  - `Type` string

## Response `200`

Event processed

- object
  - `success` boolean, required
  - `matched` number
  - `duplicates` number
  - `confirmed` boolean
  - `ignored` boolean
  - `reason` string

## Other responses

- `400`: Invalid payload
- `401`: Provider secret mismatch
- `502`: SNS confirmation request failed
- `503`: Not configured, or the event cannot be processed yet (retry later)

---

[API](https://skmtc.dev/mailly/apis/mailly-api.md) · [All operations](https://skmtc.dev/mailly/apis/mailly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailly/apis/mailly-api/revisions/1ceb29637301?raw)