SMTP2GO

SMTP2GO IP Allowlist API

Manage the account IP allow list for SMTP and API access

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /ip_allow_list Enable or disable an IP allow list · Enable IP Allow List #
Ask an LLM
“How do I turn on IP allow listing for API access?”
“Can I disable the SMTP IP allow list?”
Tell an agent
Set the {type} IP allow list enabled to {enabled} for API key {api_key}.
Enable IP allow listing using key {api_key}.
POST /ip_allow_list/add Add an IP to an allow list · Add IP Allow List #
Ask an LLM
“How do I add a new IP address to my allow list?”
“Can I label an allow-listed IP with a description?”
Tell an agent
Add IP {ip_address} to the {type} allow list using key {api_key}.
Allow-list {ip_address} described as {description} with key {api_key}.
POST /ip_allow_list/edit Change an allow-listed IP address · Edit IP Allow List #
Ask an LLM
“How do I change an IP address that's already on my allow list?”
“Can I update the description of an allow-listed IP?”
Tell an agent
Change allow-listed IP {ip_address} to {new_ip_address} using key {api_key}.
Update the description of allow-listed {ip_address} to {description} with key {api_key}.
POST /ip_allow_list/remove Remove an IP from an allow list · Remove IP Allow List #
Ask an LLM
“How do I remove an IP address from my allow list?”
“Can I delete an IP from only the SMTP allow list?”
Tell an agent destructive · confirm first
Remove IP {ip_address} from the {type} allow list using key {api_key}.
Take {ip_address} off the allow list with key {api_key}.
POST /ip_allow_list/view View an IP allow list and its status · View IP Allow List #
Ask an LLM
“Which IP addresses are on my allow list, and is it enabled?”
“Can I see the API allow list separately from the SMTP one?”
Tell an agent
Show the {type} IP allow list using key {api_key}.
List allow-listed IPs and their enabled status with key {api_key}.

Documentation

📖
Documentation
https://developers.smtp2go.com/docs/introduction-guide
📖
GettingStarted
https://developers.smtp2go.com/docs/getting-started
📖
RateLimits
https://developers.smtp2go.com/docs/rate-limiting
📖
APIReference
https://developers.smtp2go.com/reference/general-api-resources

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/smtp2go/refs/heads/main/openapi/smtp2go-ip-allowlist-api-openapi.yml

Other Resources

🔗
Endpoints
https://developers.smtp2go.com/docs/endpoints

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/smtp2go:smtp2go-ip-allowlist-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API 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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

smtp2go-ip-allowlist-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: SMTP2GO IP Allow List 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 Allowlist
  description: Manage the account IP allow list for SMTP and API access
paths:
  /ip_allow_list:
    post:
      summary: Enable IP Allow List
      operationId: ip-allowlist
      description: Enables/Disables an IP allow list.
      tags:
      - IP Allowlist
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                api_key:
                  example: api-700B************************8F4E
                  type: string
                enabled:
                  type: boolean
                  example: true
                type:
                  type: string
                  example: api
                  description: Either 'smtp' or 'api' depending on which IP allow list you want to operate on
                  default: smtp
              required:
              - api_key
      responses:
        '200':
          description: Success – IP allow list status returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    example: c0af7a72-46a8-11ee-9482-6754933d50b9
                    description: Unique ID for this request
                  data:
                    properties:
                      enabled:
                        type: boolean
                        example: true
        '400':
          description: Bad Request Response
          content:
            application/json:
              schema:
                title: 400 Bad Request
                type: object
                description: The standard payload for a 400 Bad Request response
                x-examples:
                  Example:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
                properties:
                  data:
                    type: object
                    properties:
                      error_code:
                        type: string
                        description: An API error code string
                        example: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error:
                        type: string
                        description: An error description
                        example: You do not have permission to access this API endpoint
                  request_id:
                    type: string
                    example: 40cbb6f2-935f-11e7-b5be-480fcf01a6f2
                    description: Unique ID for this request
              examples:
                Example:
                  value:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
        '429':
          description: Rate Limit Exceeded
  /ip_allow_list/add:
    post:
      summary: Add IP Allow List
      operationId: add-ip-allowlist
      description: Adds an IP address to an allow list.
      tags:
      - IP Allowlist
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                api_key:
                  example: api-700B************************8F4E
                  type: string
                description:
                  type: string
                  example: servername
                ip_address:
                  type: string
                  example: 123.45.67.89
                type:
                  type: string
                  example: api
                  description: Either 'smtp' or 'api' depending on which IP allow list you want to operate on
                  default: smtp
              required:
              - api_key
      responses:
        '200':
          description: Success – IP allow list added
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    example: c0af7a72-46a8-11ee-9482-6754933d50b9
                    description: Unique ID for this request
                  data:
                    properties:
                      description:
                        type: string
                        example: servername
                      ip_address:
                        type: string
                        example: 123.45.67.89
        '400':
          description: Bad Request Response
          content:
            application/json:
              schema:
                title: 400 Bad Request
                type: object
                description: The standard payload for a 400 Bad Request response
                x-examples:
                  Example:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
                properties:
                  data:
                    type: object
                    properties:
                      error_code:
                        type: string
                        description: An API error code string
                        example: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error:
                        type: string
                        description: An error description
                        example: You do not have permission to access this API endpoint
                  request_id:
                    type: string
                    example: 40cbb6f2-935f-11e7-b5be-480fcf01a6f2
                    description: Unique ID for this request
              examples:
                Example:
                  value:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
        '429':
          description: Rate Limit Exceeded
  /ip_allow_list/edit:
    post:
      summary: Edit IP Allow List
      operationId: edit-ip-allowlist
      description: Edits an existing IP allow list.
      tags:
      - IP Allowlist
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                api_key:
                  example: api-700B************************8F4E
                  type: string
                description:
                  type: string
                  example: servername
                ip_address:
                  type: string
                  example: 123.45.67.89
                new_ip_address:
                  type: string
                  example: 123.45.67.88
                type:
                  type: string
                  example: api
                  description: Either 'smtp' or 'api' depending on which IP allow list you want to operate on
                  default: smtp
              required:
              - api_key
      responses:
        '200':
          description: Success – IP allow list edited
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    example: c0af7a72-46a8-11ee-9482-6754933d50b9
                    description: Unique ID for this request
                  data:
                    properties:
                      description:
                        type: string
                        example: servername
                      ip_address:
                        type: string
                        example: 123.45.67.88
        '400':
          description: Bad Request Response
          content:
            application/json:
              schema:
                title: 400 Bad Request
                type: object
                description: The standard payload for a 400 Bad Request response
                x-examples:
                  Example:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
                properties:
                  data:
                    type: object
                    properties:
                      error_code:
                        type: string
                        description: An API error code string
                        example: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error:
                        type: string
                        description: An error description
                        example: You do not have permission to access this API endpoint
                  request_id:
                    type: string
                    example: 40cbb6f2-935f-11e7-b5be-480fcf01a6f2
                    description: Unique ID for this request
              examples:
                Example:
                  value:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
        '429':
          description: Rate Limit Exceeded
  /ip_allow_list/remove:
    post:
      summary: Remove IP Allow List
      operationId: remove-ip-allowlist
      description: Removes an IP address from an allow list.
      tags:
      - IP Allowlist
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                api_key:
                  example: api-700B************************8F4E
                  type: string
                ip_address:
                  type: string
                  example: 123.45.67.89
                type:
                  type: string
                  example: api
                  description: Either 'smtp' or 'api' depending on which IP allow list you want to operate on
                  default: smtp
              required:
              - api_key
      responses:
        '200':
          description: Success – IP allow list removed
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    example: c0af7a72-46a8-11ee-9482-6754933d50b9
                    description: Unique ID for this request
                  data:
                    properties:
                      description:
                        type: string
                        example: servername
                      ip_address:
                        type: string
                        example: 123.45.67.89
        '400':
          description: Bad Request Response
          content:
            application/json:
              schema:
                title: 400 Bad Request
                type: object
                description: The standard payload for a 400 Bad Request response
                x-examples:
                  Example:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
                properties:
                  data:
                    type: object
                    properties:
                      error_code:
                        type: string
                        description: An API error code string
                        example: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error:
                        type: string
                        description: An error description
                        example: You do not have permission to access this API endpoint
                  request_id:
                    type: string
                    example: 40cbb6f2-935f-11e7-b5be-480fcf01a6f2
                    description: Unique ID for this request
              examples:
                Example:
                  value:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
        '429':
          description: Rate Limit Exceeded
  /ip_allow_list/view:
    post:
      summary: View IP Allow List
      operationId: view-ip-allowlist
      description: Retrieves a list of IP Addresses on the allow list along with the list's enabled status.
      tags:
      - IP Allowlist
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                api_key:
                  example: api-700B************************8F4E
                  type: string
                type:
                  type: string
                  example: api
                  description: Either 'smtp' or 'api' depending on which IP allow list you want to operate on
                  default: smtp
              required:
              - api_key
      responses:
        '200':
          description: Success – configured webhooks returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    example: c0af7a72-46a8-11ee-9482-6754933d50b9
                    description: Unique ID for this request
                  data:
                    properties:
                      enabled:
                        type: boolean
                        example: true
                      ip_addresses:
                        type: array
                        description: list of IP addresses
                        items:
                          type: object
                          description: Represents an IP address object
                          properties:
                            ip_address:
                              type: string
                              example: 123.45.67.89
                            description:
                              type: string
                              example: servername
        '400':
          description: Bad Request Response
          content:
            application/json:
              schema:
                title: 400 Bad Request
                type: object
                description: The standard payload for a 400 Bad Request response
                x-examples:
                  Example:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
                properties:
                  data:
                    type: object
                    properties:
                      error_code:
                        type: string
                        description: An API error code string
                        example: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error:
                        type: string
                        description: An error description
                        example: You do not have permission to access this API endpoint
                  request_id:
                    type: string
                    example: 40cbb6f2-935f-11e7-b5be-480fcf01a6f2
                    description: Unique ID for this request
              examples:
                Example:
                  value:
                    data:
                      error_code: E_ApiResponseCodes.ENDPOINT_PERMISSION_DENIED
                      error: You do not have permission to access this API endpoint
                    request_id: 22e5acba-43bf-11e6-ae42-408d5cce2644
        '429':
          description: Rate Limit Exceeded
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: X-Smtp2go-Api-Key
      x-default: ${SMTP2GO_API_KEY}