MepMail Suppressions API
Addresses MepMail will not send to (bounces, complaints, unsubscribes).
Addresses MepMail will not send to (bounces, complaints, unsubscribes).
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mepmail-dev:mepmail-dev-suppressions-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Mepmail Dev Suppressions API
version: 1.0.0
description: 'Operations tagged Suppressions across 2 of this provider''s published API definitions: docs.json, mepmail-dev-docs-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
security:
- apiKey: []
tags:
- name: Suppressions
description: Addresses MepMail will not send to (bounces, complaints, unsubscribes).
paths:
/suppressions/batch/add:
post:
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BatchAddSuppressionsRequest'
example:
emails:
- bounced@example.com
- old@example.com
origin: manual
responses:
'200':
description: 'One entry per distinct address (case-insensitive) in input order; addresses already suppressed for any reason return their existing id and keep their origin. New rows record the request''s origin (bounce, complaint, manual or unsubscribe; default manual). Accepts up to 1000 addresses (Resend: 100).'
content:
application/json:
schema:
$ref: '#/components/schemas/BatchAddSuppressionsResponse'
example:
data:
- object: suppression
id: 4ef9a417-02e9-4d39-ad75-9611e0fcc33c
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: addSuppressionsBatch
summary: Suppress addresses in bulk
tags:
- Suppressions
description: Blocks up to 1,000 addresses in one request.
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
/suppressions/batch/remove:
post:
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BatchRemoveSuppressionsRequest'
example:
emails:
- old@example.com
responses:
'200':
description: Exactly one of emails or ids (up to 1000 each); lists only the rows actually removed. Rows whose address was erased (GDPR/LGPD) keep blocking sends but are hidden from the list and from lookups by email; they are reachable by id only.
content:
application/json:
schema:
$ref: '#/components/schemas/BatchRemoveSuppressionsResponse'
example:
data:
- object: suppression
id: 4ef9a417-02e9-4d39-ad75-9611e0fcc33c
deleted: true
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: removeSuppressionsBatch
summary: Remove suppressions in bulk
tags:
- Suppressions
description: Unblocks up to 1,000 addresses or ids in one request.
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
/suppressions:
post:
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateSuppressionRequest'
example:
email: bounced@example.com
origin: manual
responses:
'200':
description: 'Address blocked with the given origin (bounce, complaint, manual or unsubscribe; default manual). Idempotent: an address already suppressed for any reason (bounce, complaint, unsubscribe, manual) keeps its entry and origin, and its existing id is returned.'
content:
application/json:
schema:
$ref: '#/components/schemas/SuppressionIdResponse'
example:
object: suppression
id: ae2014de-c168-4c61-8267-70d2662a1ce1
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: createSuppression
summary: Suppress an address
tags:
- Suppressions
description: Blocks sending to one address.
get:
parameters:
- schema:
type: integer
minimum: 1
maximum: 100
description: Page size, 1-100 (default 20)
required: false
description: Page size, 1-100 (default 20)
name: limit
in: query
- schema:
type: string
format: uuid
description: 'Cursor: id of the last item of the previous page. Must be an id this list returned; there is no sentinel value.'
required: false
description: 'Cursor: id of the last item of the previous page. Must be an id this list returned; there is no sentinel value.'
name: after
in: query
- schema:
type: string
format: uuid
description: 'Cursor: id of the first item of the next page (page backwards); same rule as after.'
required: false
description: 'Cursor: id of the first item of the next page (page backwards); same rule as after.'
name: before
in: query
- schema:
type: string
enum:
- bounce
- complaint
- manual
- unsubscribe
description: 'Only suppressions of this origin: bounce, complaint, manual or unsubscribe'
required: false
description: 'Only suppressions of this origin: bounce, complaint, manual or unsubscribe'
name: origin
in: query
responses:
'200':
description: Suppressions, optionally filtered by origin (bounce, complaint, manual, or the superset value unsubscribe for retained one-click opt-outs). Rows whose address was erased (GDPR/LGPD) keep blocking sends but are hidden from the list and from lookups by email; they are reachable by id only.
content:
application/json:
schema:
$ref: '#/components/schemas/ListSuppressionsResponse'
example:
object: list
data:
- id: 4ef9a417-02e9-4d39-ad75-9611e0fcc33c
email: customer@example.com
origin: bounce
source_id: 4ef9a417-02e9-4d39-ad75-9611e0fcc33c
created_at: '2026-10-19T12:00:00.000Z'
has_more: false
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: listSuppressions
summary: List suppressions
tags:
- Suppressions
description: Lists suppressed addresses, optionally by origin.
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
/suppressions/{id}:
get:
parameters:
- schema:
type: string
minLength: 1
required: true
name: id
in: path
responses:
'200':
description: Suppression by id or by email address. Rows whose address was erased (GDPR/LGPD) keep blocking sends but are hidden from the list and from lookups by email; they are reachable by id only. An erased row reports "[erased]" as its email.
content:
application/json:
schema:
$ref: '#/components/schemas/GetSuppressionResponse'
example:
id: ae2014de-c168-4c61-8267-70d2662a1ce1
email: customer@example.com
origin: bounce
source_id: ae2014de-c168-4c61-8267-70d2662a1ce1
created_at: '2026-10-19T12:00:00.000Z'
object: suppression
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: getSuppression
summary: Retrieve a suppression
tags:
- Suppressions
description: Returns one suppression by id or email address.
delete:
parameters:
- schema:
type: string
minLength: 1
required: true
name: id
in: path
responses:
'200':
description: Suppression removed, by id or by email address; the address can receive mail again. Rows whose address was erased (GDPR/LGPD) keep blocking sends but are hidden from the list and from lookups by email; they are reachable by id only.
content:
application/json:
schema:
$ref: '#/components/schemas/RemoveSuppressionResponse'
example:
object: suppression
id: ae2014de-c168-4c61-8267-70d2662a1ce1
deleted: true
'401':
description: Missing, malformed or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: 'Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After'
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: deleteSuppression
summary: Remove a suppression
tags:
- Suppressions
description: Unblocks one address so it can receive mail again.
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
components:
schemas:
BatchAddSuppressionsRequest:
type: object
properties:
emails:
type: array
items:
type: string
format: email
minItems: 1
maxItems: 1000
description: Addresses to block, up to 1000; duplicates collapse
origin:
type: string
enum:
- bounce
- complaint
- manual
- unsubscribe
description: 'Origin recorded on rows this request creates (default manual): bounce, complaint, manual or unsubscribe; an address already suppressed keeps its origin'
required:
- emails
BatchRemoveSuppressionsResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/RemoveSuppressionResponse'
required:
- data
ErrorResponse:
type: object
properties:
statusCode:
type: number
name:
type: string
message:
type: string
required:
- statusCode
- name
- message
BatchAddSuppressionsResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/SuppressionIdResponse'
required:
- data
ListSuppressionsResponse:
type: object
properties:
object:
type: string
enum:
- list
data:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
email:
type: string
origin:
type: string
enum:
- bounce
- complaint
- manual
- unsubscribe
source_id:
type:
- string
- 'null'
format: uuid
description: Email id whose bounce/complaint created the entry
created_at:
type: string
required:
- id
- email
- origin
- source_id
- created_at
has_more:
type: boolean
required:
- object
- data
- has_more
GetSuppressionResponse:
type: object
properties:
id:
type: string
format: uuid
email:
type: string
origin:
type: string
enum:
- bounce
- complaint
- manual
- unsubscribe
source_id:
type:
- string
- 'null'
format: uuid
description: Email id whose bounce/complaint created the entry
created_at:
type: string
object:
type: string
enum:
- suppression
required:
- id
- email
- origin
- source_id
- created_at
- object
SuppressionIdResponse:
type: object
properties:
object:
type: string
enum:
- suppression
id:
type: string
format: uuid
required:
- object
- id
CreateSuppressionRequest:
type: object
properties:
email:
type: string
format: email
description: Bare email address to block; stored normalized (lowercase)
origin:
type: string
enum:
- bounce
- complaint
- manual
- unsubscribe
description: 'Origin recorded on rows this request creates (default manual): bounce, complaint, manual or unsubscribe; an address already suppressed keeps its origin'
required:
- email
BatchRemoveSuppressionsRequest:
type: object
properties:
emails:
type: array
items:
type: string
format: email
minItems: 1
maxItems: 1000
description: Addresses to unblock, up to 1000
ids:
type: array
items:
type: string
format: uuid
minItems: 1
maxItems: 1000
description: Suppression ids to remove, up to 1000
RemoveSuppressionResponse:
type: object
properties:
object:
type: string
enum:
- suppression
id:
type: string
format: uuid
deleted:
type: boolean
enum:
- true
required:
- object
- id
- deleted
securitySchemes:
apiKey:
type: http
scheme: bearer
description: 'An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.'
x-refined-from:
- docs.json
- mepmail-dev-docs-openapi.json
x-provenance:
method: harvested
publisher: MepMail
source: https://docs.mepmail.dev/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)