Postmark

Postmark Server Management API

The Server Management API API from Postmark — 2 operation(s) for server management api.

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

GET /servers/{serverid} Get a server on the account · Postmark Get a Server #
Ask an LLM
“What are the settings of one of the servers on my account?”
“Can I look up any server by ID using my account token?”
Tell an agent
Get server {serverid}.
Show the webhooks and tracking settings of server {serverid}.
PUT /servers/{serverid} Edit a server by ID · Postmark Edit a Server #
Ask an LLM
“How do I rename another server on my account?”
“Can I change the webhook URLs of a specific server by its ID?”
Tell an agent
Rename server {serverid} to {name}.
Set the delivery webhook of server {serverid} to {delivery_hook_url}.
DELETE /servers/{serverid} Delete a server · Postmark Delete a Server #
Ask an LLM
“How do I permanently remove a server I no longer need?”
“Can I delete a server from my account?”
Tell an agent destructive · confirm first
Delete server {serverid}.
Permanently remove server {serverid} from the account.
GET /servers List servers on the account · Postmark List servers #
Ask an LLM
“Which servers exist on my account?”
“Can I find a server by its name?”
Tell an agent
List the first {count} servers on my account.
Find servers named {name}.
POST /servers Create a server · Postmark Create a Server #
Ask an LLM
“How do I set up a new server to separate staging mail from production?”
“Can I configure webhooks and tracking while creating a server?”
Tell an agent
Create a new server called {name}.
Create server {name} colored {color} with open tracking set to {track_opens}.

Documentation

📖
Documentation
https://postmarkapp.com/developer
📖
GettingStarted
https://postmarkapp.com/developer/api/overview
📖
Authentication
https://postmarkapp.com/developer/api/overview#authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/postmark/refs/heads/main/openapi/postmark-server-management-api-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/postmark/refs/heads/main/asyncapi/postmark-webhooks-asyncapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/postmark/refs/heads/main/overlays/postmark-server-management-api-api-overlay.yaml

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/postmark:postmark-server-management-api-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

postmark-server-management-api-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Postmark Account Server Management API
  description: 'Postmark makes sending and receiving email incredibly easy. The Account-level API allows users to

    configure all Servers, Domains, and Sender Signatures associated

    with an Account.'
  version: 0.9.0
servers:
- url: //api.postmarkapp.com/
tags:
- name: Server Management API
paths:
  /servers/{serverid}:
    get:
      tags:
      - Server Management API
      summary: Postmark Get a Server
      operationId: getServerInformation
      parameters:
      - name: X-Postmark-Account-Token
        in: header
        description: The token associated with the Account on which this request will operate.
        required: true
        schema:
          type: string
      - name: serverid
        in: path
        description: The ID of the Server to get.
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtendedServerInfo'
        '422':
          description: An error was generated due to incorrect use of the API. See the Message associated with this response for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardPostmarkResponse'
        '500':
          description: Indicates an internal server error occurred.
          content: {}
    put:
      tags:
      - Server Management API
      summary: Postmark Edit a Server
      operationId: editServerInformation
      parameters:
      - name: X-Postmark-Account-Token
        in: header
        description: The token associated with the Account on which this request will operate.
        required: true
        schema:
          type: string
      - name: serverid
        in: path
        description: The ID of the Server to update.
        required: true
        schema:
          type: integer
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditServerPayload'
        required: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtendedServerInfo'
        '422':
          description: An error was generated due to incorrect use of the API. See the Message associated with this response for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardPostmarkResponse'
        '500':
          description: Indicates an internal server error occurred.
          content: {}
      x-codegen-request-body-name: body
    delete:
      tags:
      - Server Management API
      summary: Postmark Delete a Server
      operationId: deleteServer
      parameters:
      - name: X-Postmark-Account-Token
        in: header
        description: The token associated with the Account on which this request will operate.
        required: true
        schema:
          type: string
      - name: serverid
        in: path
        description: The ID of the Server that should be deleted.
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: OK
          content: {}
        '422':
          description: An error was generated due to incorrect use of the API. See the Message associated with this response for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardPostmarkResponse'
        '500':
          description: Indicates an internal server error occurred.
          content: {}
  /servers:
    get:
      tags:
      - Server Management API
      summary: Postmark List servers
      operationId: listServers
      parameters:
      - name: X-Postmark-Account-Token
        in: header
        description: The token associated with the Account on which this request will operate.
        required: true
        schema:
          type: string
      - name: count
        in: query
        description: Number of servers to return per request.
        required: true
        schema:
          type: integer
      - name: offset
        in: query
        description: Number of servers to skip.
        required: true
        schema:
          type: integer
      - name: name
        in: query
        description: Filter by a specific server name
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerListingResponse'
        '422':
          description: An error was generated due to incorrect use of the API. See the Message associated with this response for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardPostmarkResponse'
        '500':
          description: Indicates an internal server error occurred.
          content: {}
    post:
      tags:
      - Server Management API
      summary: Postmark Create a Server
      operationId: createServer
      parameters:
      - name: X-Postmark-Account-Token
        in: header
        description: The token associated with the Account on which this request will operate.
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateServerPayload'
        required: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtendedServerInfo'
        '422':
          description: An error was generated due to incorrect use of the API. See the Message associated with this response for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardPostmarkResponse'
        '500':
          description: Indicates an internal server error occurred.
          content: {}
      x-codegen-request-body-name: body
components:
  schemas:
    StandardPostmarkResponse:
      type: object
      properties:
        ErrorCode:
          type: integer
        Message:
          type: string
      description: A Postmark API error.
    ExtendedServerInfo:
      type: object
      properties:
        ID:
          type: integer
        Name:
          type: string
        ApiTokens:
          type: array
          items:
            type: string
        ServerLink:
          type: string
        Color:
          type: string
        SmtpApiActivated:
          type: boolean
        RawEmailEnabled:
          type: boolean
        DeliveryHookUrl:
          type: string
        InboundAddress:
          type: string
        InboundHookUrl:
          type: string
        BounceHookUrl:
          type: string
        OpenHookUrl:
          type: string
        PostFirstOpenOnly:
          type: boolean
        TrackOpens:
          type: boolean
        TrackLinks:
          type: string
          enum:
          - None
          - HtmlAndTextTracking
          - HtmlOnlyTracking
          - TextOnlyTracking
        ClickHookUrl:
          type: string
        InboundDomain:
          type: string
        InboundHash:
          type: string
        InboundSpamThreshold:
          type: integer
      description: ''
    ServerListingResponse:
      type: object
      properties:
        TotalCount:
          type: integer
        Servers:
          type: array
          items:
            $ref: '#/components/schemas/ExtendedServerInfo'
      description: The results of listing servers.
    CreateServerPayload:
      type: object
      properties:
        Name:
          type: string
        Color:
          type: string
        RawEmailEnabled:
          type: boolean
        DeliveryHookUrl:
          type: string
        SmtpApiActivated:
          type: boolean
        InboundHookUrl:
          type: string
        BounceHookUrl:
          type: string
        OpenHookUrl:
          type: string
        PostFirstOpenOnly:
          type: boolean
        TrackOpens:
          type: boolean
        TrackLinks:
          type: string
          enum:
          - None
          - HtmlAndTextTracking
          - HtmlOnlyTracking
          - TextOnlyTracking
        ClickHookUrl:
          type: string
        InboundDomain:
          type: string
        InboundSpamThreshold:
          type: integer
      description: ''
    EditServerPayload:
      type: object
      properties:
        Name:
          type: string
        Color:
          type: string
        RawEmailEnabled:
          type: boolean
        DeliveryHookUrl:
          type: string
        SmtpApiActivated:
          type: boolean
        InboundHookUrl:
          type: string
        BounceHookUrl:
          type: string
        OpenHookUrl:
          type: string
        PostFirstOpenOnly:
          type: boolean
        TrackOpens:
          type: boolean
        TrackLinks:
          type: string
          enum:
          - None
          - HtmlAndTextTracking
          - HtmlOnlyTracking
          - TextOnlyTracking
        ClickHookUrl:
          type: string
        InboundDomain:
          type: string
        InboundSpamThreshold:
          type: integer
      description: ''