Postmark API

postmarkapp · Communication

Communication No Auth Free & Open email

Postmark makes sending and receiving email incredibly easy.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Get bounces

Get bounces

https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/bounces?tag=example&type=HardBounce&count=10&offset=0&todate=example&fromdate=example&inactive=true&messageID=example&emailFilter=example

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

X-Postmark-Server-Token

example

curl -X GET "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/bounces?tag=example&type=HardBounce&count=10&offset=0&todate=example&fromdate=example&inactive=true&messageID=example&emailFilter=example" \
  -H "X-Postmark-Server-Token: example"

import requests
params = {
    "tag": "example",
    "type": "HardBounce",
    "count": "10",
    "offset": "0",
    "todate": "example",
    "fromdate": "example",
    "inactive": "true",
    "messageID": "example",
    "emailFilter": "example"
}
headers = {
    "X-Postmark-Server-Token": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/bounces",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/bounces');
url.searchParams.set('tag', 'example');
url.searchParams.set('type', 'HardBounce');
url.searchParams.set('count', '10');
url.searchParams.set('offset', '0');
url.searchParams.set('todate', 'example');
url.searchParams.set('fromdate', 'example');
url.searchParams.set('inactive', 'true');
url.searchParams.set('messageID', 'example');
url.searchParams.set('emailFilter', 'example');

const response = await fetch(url, {
  headers: {
    'X-Postmark-Server-Token': 'example'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/bounces")
	q := baseURL.Query()
	q.Set("tag", "example")
	q.Set("type", "HardBounce")
	q.Set("count", "10")
	q.Set("offset", "0")
	q.Set("todate", "example")
	q.Set("fromdate", "example")
	q.Set("inactive", "true")
	q.Set("messageID", "example")
	q.Set("emailFilter", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("X-Postmark-Server-Token", "example")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/bounces")
uri.query = URI.encode_www_form({
  "tag" => "example",
  "type" => "HardBounce",
  "count" => "10",
  "offset" => "0",
  "todate" => "example",
  "fromdate" => "example",
  "inactive" => "true",
  "messageID" => "example",
  "emailFilter" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["X-Postmark-Server-Token"] = "example"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/bounces?" . http_build_query([
    "tag" => "example",
    "type" => "HardBounce",
    "count" => "10",
    "offset" => "0",
    "todate" => "example",
    "fromdate" => "example",
    "inactive" => "true",
    "messageID" => "example",
    "emailFilter" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "X-Postmark-Server-Token: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get the Templates associated with this Server

Get the Templates associated with this Server

https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/templates?Count=10&Offset=0

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

X-Postmark-Server-Token

example

curl -X GET "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/templates?Count=10&Offset=0" \
  -H "X-Postmark-Server-Token: example"

import requests
params = {
    "Count": "10",
    "Offset": "0"
}
headers = {
    "X-Postmark-Server-Token": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/templates",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/templates');
url.searchParams.set('Count', '10');
url.searchParams.set('Offset', '0');

const response = await fetch(url, {
  headers: {
    'X-Postmark-Server-Token': 'example'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/templates")
	q := baseURL.Query()
	q.Set("Count", "10")
	q.Set("Offset", "0")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("X-Postmark-Server-Token", "example")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/templates")
uri.query = URI.encode_www_form({
  "Count" => "10",
  "Offset" => "0"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["X-Postmark-Server-Token"] = "example"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/templates?" . http_build_query([
    "Count" => "10",
    "Offset" => "0"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "X-Postmark-Server-Token: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Inbound message search

Inbound message search

https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/messages/inbound?tag=example&count=10&offset=0&status=blocked&todate=example&subject=example&fromdate=example&fromemail=example&recipient=example&mailboxhash=example

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

X-Postmark-Server-Token

example

curl -X GET "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/messages/inbound?tag=example&count=10&offset=0&status=blocked&todate=example&subject=example&fromdate=example&fromemail=example&recipient=example&mailboxhash=example" \
  -H "X-Postmark-Server-Token: example"

import requests
params = {
    "tag": "example",
    "count": "10",
    "offset": "0",
    "status": "blocked",
    "todate": "example",
    "subject": "example",
    "fromdate": "example",
    "fromemail": "example",
    "recipient": "example",
    "mailboxhash": "example"
}
headers = {
    "X-Postmark-Server-Token": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/messages/inbound",
    params=params,
    headers=headers,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/messages/inbound');
url.searchParams.set('tag', 'example');
url.searchParams.set('count', '10');
url.searchParams.set('offset', '0');
url.searchParams.set('status', 'blocked');
url.searchParams.set('todate', 'example');
url.searchParams.set('subject', 'example');
url.searchParams.set('fromdate', 'example');
url.searchParams.set('fromemail', 'example');
url.searchParams.set('recipient', 'example');
url.searchParams.set('mailboxhash', 'example');

const response = await fetch(url, {
  headers: {
    'X-Postmark-Server-Token': 'example'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/messages/inbound")
	q := baseURL.Query()
	q.Set("tag", "example")
	q.Set("count", "10")
	q.Set("offset", "0")
	q.Set("status", "blocked")
	q.Set("todate", "example")
	q.Set("subject", "example")
	q.Set("fromdate", "example")
	q.Set("fromemail", "example")
	q.Set("recipient", "example")
	q.Set("mailboxhash", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)
	req.Header.Set("X-Postmark-Server-Token", "example")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/messages/inbound")
uri.query = URI.encode_www_form({
  "tag" => "example",
  "count" => "10",
  "offset" => "0",
  "status" => "blocked",
  "todate" => "example",
  "subject" => "example",
  "fromdate" => "example",
  "fromemail" => "example",
  "recipient" => "example",
  "mailboxhash" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)
req["X-Postmark-Server-Token"] = "example"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/postmarkapp.com/server/1.0.0/messages/inbound?" . http_build_query([
    "tag" => "example",
    "count" => "10",
    "offset" => "0",
    "status" => "blocked",
    "todate" => "example",
    "subject" => "example",
    "fromdate" => "example",
    "fromemail" => "example",
    "recipient" => "example",
    "mailboxhash" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
    "header" => implode("\r\n", [
        "X-Postmark-Server-Token: example"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Postmark API?

Postmark API is a Communication API. Developers commonly use communication APIs for:

sending SMS alerts and notifications
building in-app chat and messaging features
automating email sequences and transactional emails
creating voice bots and IVR systems
verifying phone numbers at signup

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Postmark API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗