---
title: "Receive SES feedback from Amazon SNS"
method: POST
path: "/api/email/feedback/sns"
tags: ["internal"]
---

# Receive SES feedback from Amazon SNS

`POST /api/email/feedback/sns`

## Request

- Base URL: `https://app.scanopy.net`
- URL: `https://app.scanopy.net/api/email/feedback/sns`
- Auth: none declared

The HTTPS subscription endpoint for the SNS topic named by
`SCANOPY_EMAIL_FEEDBACK_SNS_TOPIC_ARN`. Confirms the subscription, and
applies SES bounce and complaint notifications. Answers 404 when no topic
is configured.

## Request body `text/plain`

- string

## Response `200`

Message processed

- ApiResponse: Envelope for a successful response. Failures are sent with a non-2xx status and an `ApiErrorResponse` body instead.
  - `data` TupleUnit: No payload. Present only so the envelope keeps its shape.
  - `error` string, nullable: Not sent on a successful response. Failure messages arrive in an `ApiErrorResponse`.
  - `meta` ApiMeta, required: API metadata included in all responses
    - `api_version` integer, required: API version (integer, increments on breaking changes)
    - `server_version` string, required: Server version (semver)
  - `success` boolean, required: Always `true` on a successful response.

## Other responses

- `400`: Not an authentic message for the configured topic
- `404`: SES feedback is not configured

## Changes

- **2026-10-11** `2f240aecf121`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scanopy/apis/scanopy-api/changes/api/email/feedback/sns/post.md)

---

[API](https://skmtc.dev/scanopy/apis/scanopy-api.md) - [All operations](https://skmtc.dev/scanopy/apis/scanopy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scanopy/apis/scanopy-api/revisions/966ba786bdb5?raw)