Postmark

Postmark Outbound API

The Outbound API from Postmark — 20 operation(s) for outbound.

GitHub OpenAPI

Operations 10

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 /stats/outbound/clicks Count link clicks per day · Postmark Get click counts #
Ask an LLM
“How many link clicks did my emails get each day?”
“What's the daily click volume on messages with one tag?”
Tell an agent
Show daily click counts since {fromdate}.
Count total and unique clicks for tag {tag} through {todate}.
GET /stats/outbound/clicks/platforms Break down link clicks by device platform · Postmark Get browser plaform usage #
Ask an LLM
“Do people click my email links more from phones or desktops?”
“What platform split do link clicks show over a date range?”
Tell an agent
Break down link clicks by mobile versus desktop from {fromdate} to {todate}.
Show the click platform mix for tag {tag}.
GET /stats/outbound/opens Count email opens per day · Postmark Get email open counts #
Ask an LLM
“How many opens and unique opens did my emails get each day?”
“What's the open trend for a specific tag over time?”
Tell an agent
Show daily open counts since {fromdate}.
Count total and unique opens for tag {tag} up to {todate}.
GET /stats/outbound/opens/platforms Break down opens by device platform · Postmark Get email platform usage #
Ask an LLM
“Are my emails opened more on mobile, desktop or webmail?”
“What platform split do opens show for one tag?”
Tell an agent
Break down email opens by mobile, desktop and webmail since {fromdate}.
Show the open platform mix for tag {tag}.
GET /stats/outbound/opens/readtimes See how long recipients spend reading emails · Postmark Get email read times #
Ask an LLM
“How long do recipients spend reading my emails after opening them?”
“What's the read-time breakdown for messages with one tag?”
Tell an agent
Show email read times from {fromdate} to {todate}.
Break down how long readers spent on emails tagged {tag}.
GET /stats/outbound Get an overview of outbound email stats · Postmark Get outbound overview #
Ask an LLM
“How is my outbound email performing overall this month?”
“Can I get a single summary of sends, bounces, spam and opens for a tag?”
Tell an agent
Give me the outbound stats overview from {fromdate} to {todate}.
Summarize all outbound performance for tag {tag}.
GET /stats/outbound/bounces Count bounces per day by type · Postmark Get bounce counts #
Ask an LLM
“How many hard and soft bounces did I get each day?”
“Is my bounce volume trending up over a date range?”
Tell an agent
Show daily bounce counts from {fromdate} to {todate}.
Chart bounce totals for messages tagged {tag}.
GET /stats/outbound/sends Count emails sent per day · Postmark Get sent counts #
Ask an LLM
“How many emails did I send each day last week?”
“What's my daily send volume for a particular tag?”
Tell an agent
Show daily sent counts since {fromdate}.
Count the emails sent with tag {tag} up to {todate}.
GET /stats/outbound/spam Count spam complaints per day · Postmark Get spam complaints #
Ask an LLM
“How many recipients marked my emails as spam?”
“Are spam complaints rising for one of my email campaigns?”
Tell an agent
Show spam complaint counts since {fromdate}.
Count spam complaints on email tagged {tag}.
GET /stats/outbound/tracked Count emails sent with tracking enabled · Postmark Get tracked email counts #
Ask an LLM
“How many of my emails went out with open or link tracking turned on?”
“What share of a tag's messages were tracked?”
Tell an agent
Show the tracked email counts from {fromdate} to {todate}.
Count tracked emails with tag {tag}.

Documentation

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

Specifications

⚙
OpenAPI
https://artifacts.apis.io/postmark/openapi/postmark-outbound-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/postmark/asyncapi/postmark-webhooks-asyncapi.yml

Other Resources

🔗
Overlay
https://artifacts.apis.io/postmark/overlays/postmark-outbound-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-outbound-api"
All apis 
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.

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-outbound-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Postmark Outbound API
  description: 'Postmark helps deliver and track application email. In a nutshell, the

    service replaces SMTP (or Sendmail) with a far more reliable, scalable and

    care-free environment. In addition, you can track statistics such as

    number of emails sent or processed, opens, bounces and spam complaints.'
  version: 1.0.0
servers:
- url: http://{{baseurl}}
tags:
- name: Outbound
paths:
  /stats/outbound/clicks:
    get:
      tags:
      - Outbound
      summary: Postmark Get click counts
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutboundClicks
      x-operation-id-source: derived
  /stats/outbound/clicks/platforms:
    get:
      tags:
      - Outbound
      summary: Postmark Get browser plaform usage
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutboundClicksPlatforms
      x-operation-id-source: derived
  /stats/outbound/opens:
    get:
      tags:
      - Outbound
      summary: Postmark Get email open counts
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutboundOpens
      x-operation-id-source: derived
  /stats/outbound/opens/platforms:
    get:
      tags:
      - Outbound
      summary: Postmark Get email platform usage
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutboundOpensPlatforms
      x-operation-id-source: derived
  /stats/outbound/opens/readtimes:
    get:
      tags:
      - Outbound
      summary: Postmark Get email read times
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutboundOpensReadtimes
      x-operation-id-source: derived
  /stats/outbound:
    get:
      tags:
      - Outbound
      summary: Postmark Get outbound overview
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutbound
      x-operation-id-source: derived
  /stats/outbound/bounces:
    get:
      tags:
      - Outbound
      summary: Postmark Get bounce counts
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutboundBounces
      x-operation-id-source: derived
  /stats/outbound/sends:
    get:
      tags:
      - Outbound
      summary: Postmark Get sent counts
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutboundSends
      x-operation-id-source: derived
  /stats/outbound/spam:
    get:
      tags:
      - Outbound
      summary: Postmark Get spam complaints
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutboundSpam
      x-operation-id-source: derived
  /stats/outbound/tracked:
    get:
      tags:
      - Outbound
      summary: Postmark Get tracked email counts
      parameters:
      - name: tag
        in: query
        schema:
          type: string
        description: Filter by tag
        example: <string>
      - name: fromdate
        in: query
        schema:
          type: string
        description: Filter messages starting from the date specified. e.g. `2014-02-01`
        example: <string>
      - name: todate
        in: query
        schema:
          type: string
        description: Filter messages up to the date specified. e.g. `2014-02-01`
        example: <string>
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
      operationId: getStatsOutboundTracked
      x-operation-id-source: derived