Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/smtp2go-suppressions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: SMTP2GO SUPPRESSIONS API
version: 3.0.4
description: The SMTP2GO v3 REST API for sending transactional email and SMS, managing sender domains and single sender emails, SMTP users, API keys, IP allow lists and IP auth, templates, webhooks, suppressions, subaccounts, dedicated IPs, email archive, activity search and delivery statistics. Every operation is a POST (with a PATCH variant on two paths) carrying a JSON body; authentication is an API key supplied in the X-Smtp2go-Api-Key header or as an api_key field in the request body.
contact:
name: SMTP2GO Support
url: https://support.smtp2go.com/
termsOfService: https://www.smtp2go.com/terms/
x-harvest:
source: https://developers.smtp2go.com/mcp
method: MCP tools/call get-endpoint, one call per path+method, assembled verbatim
harvested: '2026-08-13'
server_info:
name: SMTP2GO-API-Docs
version: 3.0.4
note: SMTP2GO does not publish a single fetchable OpenAPI URL; the ReadMe registry path answers 429 to non-browser clients. The provider's own remote MCP server returns the authoritative OpenAPI 3.1.0 fragment for each endpoint anonymously, and those 73 fragments are merged here without modification.
servers:
- url: https://api.smtp2go.com/v3
description: Regionless
- url: https://us-api.smtp2go.com/v3
description: US Region
- url: https://eu-api.smtp2go.com/v3
description: EU Region
- url: https://au-api.smtp2go.com/v3
description: AU Region
security:
- sec0: []
tags:
- name: SUPPRESSIONS
description: Add, view and remove suppressed addresses
paths:
/suppression/add:
post:
tags:
- SUPPRESSIONS
summary: Add a suppression
description: Suppresses the specified email address or domain
operationId: add-a-suppression
requestBody:
content:
application/json:
schema:
type: object
required:
- email_address
properties:
email_address:
type: string
description: The email address or domain you would like to suppress from deliveries
block_description:
type: string
description: The description given for suppressing the email or domain from deliveries
subaccount_id:
type: string
description: If you wish to make this API call on behalf of a subaccount then include its unique ID here
responses:
'200':
description: Suppression successful
content:
application/json:
examples:
Result:
value:
request_id: aa253464-0bd0-467a-b24b-6159dcd7be60
data:
added: true
block_description: ''
email_address: temp@example.com
schema:
type: object
required:
- request_id
- data
properties:
request_id:
type: string
example: aa253464-0bd0-467a-b24b-6159dcd7be60
data:
type: object
required:
- block_description
- added
- email_address
properties:
block_description:
type: string
example: No longer a customer.
added:
type: boolean
example: true
default: true
email_address:
type: string
example: test@example.com
'400':
description: '400'
content:
application/json:
examples:
Result:
value:
request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
data:
error: You do not have permission to access this API endpoint
error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
schema:
type: object
properties:
request_id:
type: string
example: 22e5acba-43bf-11e6-ae42-408d5cce2644
data:
type: object
properties:
error:
type: string
example: You do not have permission to access this API endpoint
error_code:
type: string
example: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
deprecated: false
/suppression/remove:
post:
tags:
- SUPPRESSIONS
summary: Remove a suppression
description: Removes the suppression on the specified email address or domain
operationId: remove-a-suppression
requestBody:
content:
application/json:
schema:
type: object
required:
- email_address
- reasons
properties:
email_address:
type: string
description: The email address or domain you would like to remove from your suppression list
default: test@example.com
reasons:
type: array
description: A list of block types you would like to remove for the given email or domain
default:
- manual
- spam
items:
type: string
subaccount_id:
type: string
description: If you wish to make this API call on behalf of a subaccount then include its unique ID here
responses:
'200':
description: Suppression removed
content:
application/json:
examples:
Result:
value:
request_id: be4811ac-63f2-11ed-ab1c-f23c9216bfec
data:
suppressions:
- email_address: temp@test.com
reason: manual
removed: true
- email_address: temp@test.com
reason: spam
removed: false
schema:
type: object
required:
- request_id
- data
properties:
request_id:
type: string
example: aa253464-0bd0-467a-b24b-6159dcd7be60
data:
type: object
required:
- suppressions
properties:
suppressions:
type: array
items:
type: object
required:
- reason
- email_address
- removed
properties:
reason:
type: string
example: manual
email_address:
type: string
example: test@example.com
removed:
type: boolean
example: true
default: true
'400':
description: '400'
content:
application/json:
examples:
Result:
value:
request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
data:
error: You do not have permission to access this API endpoint
error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
schema:
type: object
properties:
request_id:
type: string
example: 22e5acba-43bf-11e6-ae42-408d5cce2644
data:
type: object
properties:
error:
type: string
example: You do not have permission to access this API endpoint
error_code:
type: string
example: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
deprecated: false
/suppression/view:
post:
tags:
- SUPPRESSIONS
summary: View suppressions
description: Returns your suppressed email addresses and domains
operationId: view-suppressions
requestBody:
content:
application/json:
schema:
type: object
properties:
continue_token:
type: string
description: If returned from a request this can be passed to continue paging through the result of the results
email_address:
type: string
description: If provided, checks if a specific email address or domain is in the block list
end_date:
type: string
description: ISO-8601 formatted datetime which defaults to 30 days prior to the current date at midnight. Timezone is UTC
fuzzy:
type: boolean
description: Indicates if the search should use fuzzy matching on recipients & reasons
reason:
type: string
description: A reason string to search for
reasons:
type: array
description: An array of reason strings to search for
items:
type: string
recipient:
type: string
description: A recipient string to search for
recipients:
type: array
description: An array of recipient strings to search for
items:
type: string
sort:
type: string
description: The direction to sort the results, either <code>asc</code> or <code>desc</code>
start_date:
type: string
description: ISO-8601 formatted datetime which defaults to the current date at midnight. Timezone is UTC
suppression_type:
type: string
description: If passed restricts the search to a single suppression type <code>manual</code>, <code>spam</code>, <code>unsubscribe</code>, <code>bounce</code> or <code>compliance</code>
suppression_types:
type: array
description: If passed restricts the search to multiple suppression types <code>manual</code>, <code>spam</code>, <code>unsubscribe</code>, <code>bounce</code> or <code>compliance</code>
items:
type: string
wildcard:
type: string
description: If provided, only suppressions with this wildcard string in name, domain, or email address fields, will be returned
subaccount_id:
type: string
description: If you wish to make this API call on behalf of a subaccount then include its unique ID here
responses:
'200':
description: List of suppressions
content:
application/json:
examples:
Result:
value:
request_id: 0d782ff6-63f2-11ed-9e11-f23c92160e3c
data:
continue_token: null
results:
- block_description: ''
complaint: ''
email_address: temp@example.com
reason: manual
subject: null
timestamp: '2022-11-14 07:54:45'
total_results: 1
schema:
type: object
required:
- request_id
- data
properties:
request_id:
type: string
example: e61431d0-a532-11e8-a307-f23c91285f72
data:
type: object
required:
- continue_token
- results
- total_results
properties:
results:
type: array
items:
type: object
required:
- complaint
- reason
- block_description
- timestamp
- email_address
properties:
complaint:
type: string
example: ''
reason:
type: string
example: manual
block_description:
type: string
example: no longer a customer
timestamp:
type: string
example: '2018-08-21 11:10:55.457489+00:00'
email_address:
type: string
example: test@example.com
continue_token:
type: string
nullable: true
total_results:
type: integer
'400':
description: '400'
content:
application/json:
examples:
Result:
value:
request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
data:
error: You do not have permission to access this API endpoint
error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
schema:
type: object
properties:
request_id:
type: string
example: 22e5acba-43bf-11e6-ae42-408d5cce2644
data:
type: object
properties:
error:
type: string
example: You do not have permission to access this API endpoint
error_code:
type: string
example: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
deprecated: false
components:
securitySchemes:
sec0:
type: apiKey
in: header
name: X-Smtp2go-Api-Key
x-default: ${SMTP2GO_API_KEY}