MepMail Topics API
Subscription topics contacts can opt in and out of.
Subscription topics contacts can opt in and out of.
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-topics-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 Topics API
version: 1.0.0
description: 'Operations tagged Topics 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: Topics
description: Subscription topics contacts can opt in and out of.
paths:
/topics:
post:
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateTopicRequest'
example:
name: Product updates
description: News about features and releases
default_subscription: opt_in
visibility: public
responses:
'200':
description: Topic created
content:
application/json:
schema:
$ref: '#/components/schemas/TopicResponse'
example:
id: ae2014de-c168-4c61-8267-70d2662a1ce1
name: Order updates
description: Shipping and delivery updates
default_subscription: opt_in
visibility: private
created_at: '2026-10-19T12:00:00.000Z'
'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: createTopic
summary: Create a topic
tags:
- Topics
description: Creates a subscription topic with its default opt-in.
get:
responses:
'200':
description: Topics
content:
application/json:
schema:
$ref: '#/components/schemas/ListTopicsResponse'
example:
object: list
data:
- id: 4ef9a417-02e9-4d39-ad75-9611e0fcc33c
name: Order updates
description: Shipping and delivery updates
default_subscription: opt_in
visibility: private
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'
'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: listTopics
summary: List topics
tags:
- Topics
description: Lists the team's topics.
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
/topics/{id}:
get:
parameters:
- schema:
type: string
format: uuid
required: true
name: id
in: path
responses:
'200':
description: Topic
content:
application/json:
schema:
$ref: '#/components/schemas/TopicResponse'
example:
id: ae2014de-c168-4c61-8267-70d2662a1ce1
name: Order updates
description: Shipping and delivery updates
default_subscription: opt_in
visibility: private
created_at: '2026-10-19T12:00:00.000Z'
'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: getTopic
summary: Retrieve a topic
tags:
- Topics
description: Returns one topic.
patch:
parameters:
- schema:
type: string
format: uuid
required: true
name: id
in: path
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateTopicRequest'
example:
description: Monthly product news
responses:
'200':
description: Topic updated
content:
application/json:
schema:
$ref: '#/components/schemas/TopicIdResponse'
example:
id: ae2014de-c168-4c61-8267-70d2662a1ce1
'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'
'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: updateTopic
summary: Update a topic
tags:
- Topics
description: Renames a topic or changes its description or visibility.
delete:
parameters:
- schema:
type: string
format: uuid
required: true
name: id
in: path
responses:
'200':
description: Topic deleted
content:
application/json:
schema:
$ref: '#/components/schemas/RemoveTopicResponse'
example:
id: ae2014de-c168-4c61-8267-70d2662a1ce1
object: topic
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'
'409':
description: Topic is in use
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: deleteTopic
summary: Delete a topic
tags:
- Topics
description: Deletes a topic.
servers:
- url: https://api.mepmail.dev
description: MepMail Cloud
- url: '{baseUrl}'
description: Self-hosted instance
variables:
baseUrl:
default: http://localhost:3001
components:
schemas:
ErrorResponse:
type: object
properties:
statusCode:
type: number
name:
type: string
message:
type: string
required:
- statusCode
- name
- message
TopicResponse:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
description:
type: string
default_subscription:
type: string
enum:
- opt_in
- opt_out
visibility:
type: string
enum:
- private
- public
created_at:
type: string
required:
- id
- name
- default_subscription
- visibility
- created_at
CreateTopicRequest:
type: object
properties:
name:
type: string
minLength: 1
description:
type: string
default_subscription:
type: string
enum:
- opt_in
- opt_out
visibility:
type: string
enum:
- private
- public
required:
- name
- default_subscription
UpdateTopicRequest:
type: object
properties:
name:
type: string
minLength: 1
description:
type: string
visibility:
type: string
enum:
- private
- public
ListTopicsResponse:
type: object
properties:
object:
type: string
enum:
- list
data:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
description:
type: string
default_subscription:
type: string
enum:
- opt_in
- opt_out
visibility:
type: string
enum:
- private
- public
created_at:
type: string
required:
- id
- name
- default_subscription
- visibility
- created_at
has_more:
type: boolean
enum:
- false
required:
- object
- data
- has_more
RemoveTopicResponse:
type: object
properties:
id:
type: string
format: uuid
object:
type: string
enum:
- topic
deleted:
type: boolean
enum:
- true
required:
- id
- object
- deleted
TopicIdResponse:
type: object
properties:
id:
type: string
format: uuid
required:
- id
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)