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/smtp2go-ip-auth-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: SMTP2GO IP AUTH 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: IP AUTH
description: Manage IP-authenticated sending entries
paths:
/ip_auth/edit:
patch:
tags:
- IP AUTH
summary: Patch an IP Auth
description: Patch an existing IP Auth ignoring missing properties
operationId: patch-ip-auth
requestBody:
content:
application/json:
schema:
type: object
required:
- ip_address
properties:
ip_address:
type: string
description: A valid IP address of your existing IP Auth that you wish to edit
example: 127.0.0.1
description:
type: string
description: A comment or description of the IP Auth
example: test smtp user
custom_ratelimit:
type: boolean
description: If true, a custom rate limit will be enabled for this user, and defined by the <code>custom_ratelimit_value</code> and <code>custom_ratelimit_period</code>.
custom_ratelimit_value:
type: integer
description: If passed, defines the limit of emails this user can send in the period specified in <code>custom_ratelimit_period</code>.<br><br><strong>Note:</strong> Only stores this value if <code>custom_ratelimit</code> is true.
custom_ratelimit_period:
type: string
example: 0:30:00
description: 'If passed, defines the period for which this user will be limited to the number of emails specified in <code>custom_ratelimit_value</code>.<br><br><strong>Syntax:</strong> "\<n\> [hour[s]|day[s]|week[s]|month[s]] [hh:mm:ss]".<br><br><strong>Examples: </strong> "0:30:00", "1 hour", "2 days", "3 months", "4 months 5:00:00".<br><br><strong>Note:</strong> Only stores this value if <code>custom_ratelimit</code> is true.'
ip_pool:
type: integer
description: If passed, any emails sent with this IP Auth will use dedicated IP's in this IP Pool, This value can be found on the <code>/v3/dedicated_ips/view</code> endpoint.
example: 1234
feedback_enabled:
type: boolean
description: If true, custom feedback via the unsubscribe footer will be enabled and defined by the below settings.
default: null
feedback_html:
type: string
description: The HTML content to insert into the custom feedback email body via the unsubscribe footer.<br><br><strong>System Variables (Only available here):</strong><ul><li>Unsubscribe URL = %%UNSUBSCRIBE%% </li><li>Email address = %%EMAIL%%</li></ul>
example: test_html
default: null
feedback_text:
type: string
description: The text content to insert into the custom feedback email body via the unsubscribe footer.<br><br><strong>System Variables (Only available here):</strong><ul><li>Unsubscribe URL = %%UNSUBSCRIBE%% </li><li>Email address = %%EMAIL%%</li></ul>
example: test_text
default: null
open_tracking_enabled:
type: boolean
description: If true, open tracking will be enabled for this IP Auth user.
default: null
click_tracking_enabled:
type: boolean
description: If true, click tracking will be enabled for this IP Auth.
default: null
archive_enabled:
type: boolean
description: If true, archiving (available on paid plans) will be enabled for this IP Auth.
default: null
audit_email:
type: string
description: If passed, this email will be BCC'd on all emails sent by this IP Auth.
bounce_notifications:
type: string
description: If passed, will control how bounce notifications are handled. Must be one of [from, drop, or a valid email address]. [from] will return the email to sender, [drop] will discard the event, and the inclusion of an email address will send the event on to this account.
default: null
status:
type: string
description: The initial status of the IP Auth user, one of ['allowed', 'blocked', 'sandbox'].
default: null
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: Successfully patched IP Auth
content:
application/json:
examples:
Result:
value:
request_id: f3e50113-deb2-4e54-9675-2ea497c3732e
data:
- ip_address: 127.0.0.1
description: test ip auth
feedback_enabled: true
feedback_html: test_html
feedback_text: test_text
ippool: 1234
bounce_notifications: from
status: allowed
schema:
type: object
required:
- data
- request_id
properties:
data:
type: array
description: An array of IP Auth results
items:
type: object
required:
- request_id
- data
properties:
request_id:
type: string
example: aa253464-0bd0-467a-b24b-6159dcd7be60
data:
type: object
properties:
ip_address:
type: string
example: ip_address
description: The IP address of the IP Auth
description:
type: string
description: A comment or description of the IP Auth.
custom_rate_limit:
type: boolean
example: true
default: false
description: If enabled will use the values of <code>custom_ratelimit_value</code> and <code>custom_ratelimit_period</code> for rate limiting.
custom_ratelimit_value:
type: integer
example: 123
description: If passed, defines the limit of emails this IP Auth can send in the period specified in <code>custom_ratelimit_period</code>.
custom_ratelimit_period:
type: string
example: 0:30:00
description: 'If passed, defines the period for which this user will be limited to the number of emails specified in <code>custom_ratelimit_value</code>.<br><br><strong>Syntax:</strong> "\<n\> [hour[s]|day[s]|week[s]|month[s]] [hh:mm:ss]".<br><br><strong>Examples: </strong> "0:30:00", "1 hour", "2 days", "3 months", "4 months 5:00:00".<br><br><strong>Note:</strong> Only stores this value if <code>custom_ratelimit</code> is true.'
default_ratelimit_value:
type: string
example: 123
description: The default limit of emails this IP Auth can send in the period specified in <code>default_ratelimit_period</code>. <strong>Note:</strong> Used if <code>custom_ratelimit</code> is false.
default_ratelimit_period:
type: string
example: unlimited
description: 'The default period for which this IP Auth will be limited to the number of emails specified in <code>default_ratelimit_value</code>.<br><br><strong>Syntax:</strong> "\<n\> [hour[s]|day[s]|week[s]|month[s]] [hh:mm:ss]".<br><br><strong>Examples: </strong> "0:30:00", "1 hour", "2 days", "3 months", "4 months 5:00:00".<br><br><strong>Note:</strong> Used if <code>custom_ratelimit</code> is false.'
ippool:
type: integer
example: 1234
feedback_enabled:
type: boolean
description: If true, custom feedback via the unsubscribe footer will be enabled and defined by the below settings.
default: false
feedback_html:
type: string
description: 'The HTML content to insert into the custom feedback email body via the unsubscribe footer. Default: blank <br><br><strong>System Variables (Only available here):</strong><ul><li>Unsubscribe URL = %%UNSUBSCRIBE%% </li><li>Email address = %%EMAIL%%</li></ul>'
feedback_text:
type: string
description: 'The text content to insert into the custom feedback email body via the unsubscribe footer. Default: blank<br><br><strong>System Variables (Only available here):</strong><ul><li>Unsubscribe URL = %%UNSUBSCRIBE%% </li><li>Email address = %%EMAIL%%</li></ul>'
open_tracking_enabled:
type: boolean
description: If true, open tracking will be enabled for this IP Auth.
default: false
click_tracking_enabled:
type: boolean
description: If true, click tracking will be enabled for this IP Auth.
default: false
archive_enabled:
type: boolean
description: If true, archiving (available on paid plans) will be enabled for this IP Auth.
default: false
audit_email:
type: string
description: If passed, this email will be BCC'd on all emails sent by this IP Auth.
bounce_notifications:
type: string
description: If passed, will control how bounce notifications are handled. Must be one of [from, drop, or a valid email address]. [from] will return the email to sender, [drop] will discard the event, and the inclusion of an email address will send the event on to this account.
default: from
status:
type: string
description: The initial status of the IP Auth, one of ['allowed', 'blocked', 'sandbox'].
default: allowed
request_id:
type: string
example: 4b661d88-6b2d-11eb-8bb3-f23c92bb31d2
'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
/ip_auth/remove:
post:
tags:
- IP AUTH
summary: Remove an IP Auth entry
description: Remove an IP Auth entry from your account
operationId: remove-ip-auth
requestBody:
content:
application/json:
schema:
type: object
required:
- ip_address
properties:
ip_address:
type: string
description: A valid ip address of an existing IP Auth entry that you wish to remove
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: IP Auth removed
'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
/ip_auth/view:
post:
tags:
- IP AUTH
summary: View IP Auth
description: Returns a list of all IP Auth entries that are managed by this account, or details of a specific IP Auth, when you include the [ip_address] in your request. If no entries are available, this will return an empty list.
operationId: view-ip-auth
requestBody:
content:
application/json:
schema:
type: object
properties:
ip_address:
type: string
description: If passed, a valid ip address of an existing IP Auth entry that you wish to view
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 IP Auth entries
content:
application/json:
examples:
Result:
value:
request_id: ae4a8446-63c6-11ed-95d3-f23c92160e3c
data:
results:
- ip_address: 127.0.0.1
sending_allowed: true
custom_ratelimit: false
custom_ratelimit_value: null
custom_ratelimit_period: 0:00:00
description: ''
feedback_enabled: false
feedback_domain: default
feedback_html: ''
feedback_text: ''
archive_enabled: false
open_tracking_enabled: false
audit_email: null
bounce_notifications: from
status: allowed
default_ratelimit_value: 0
default_ratelimit_period: unlimited
schema:
type: object
required:
- request_id
- data
properties:
request_id:
type: string
example: aa253464-0bd0-467a-b24b-6159dcd7be60
data:
type: object
required:
- results
properties:
results:
type: array
items:
type: object
required:
- ip_addres
- sending_allowed
- custom_ratelimit
properties:
comments:
type: string
example: Comment explaining how amazing this IP Auth entry is
ip_addres:
type: string
example: 127.0.0.1
email_password:
type: string
example: H#8dkK2djs
deprecated: true
sending_allowed:
type: boolean
example: true
default: true
custom_ratelimit:
type: boolean
example: true
default: true
custom_ratelimit_value:
type: integer
example: 100
default: 0
nullable: true
custom_ratelimit_period:
type: string
example: 1 day
default_ratelimit_value:
type: string
example: 123
description: The default limit of emails this IP Auth user can send in the period specified in <code>default_ratelimit_period</code>. <strong>Note:</strong> Used if <code>custom_ratelimit</code> is false.
default_ratelimit_period:
type: string
example: unlimited
description: 'The default period for which this IP Auth will be limited to the number of emails specified in <code>default_ratelimit_value</code>.<br><br><strong>Syntax:</strong> "\<n\> [hour[s]|day[s]|week[s]|month[s]] [hh:mm:ss]".<br><br><strong>Examples: </strong> "0:30:00", "1 hour", "2 days", "3 months", "4 months 5:00:00".<br><br><strong>Note:</strong> Used if <code>custom_ratelimit</code> is false.'
ippool:
type: integer
example: 1234
description:
type: string
feedback_enabled:
type: boolean
example: true
feedback_domain:
type: string
example: default
feedback_html:
type: string
feedback_text:
type: string
archive_enabled:
type: boolean
example: true
open_tracking_enabled:
type: boolean
example: true
audit_email:
type: string
nullable: true
bounce_notifications:
type: string
example: from
'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}