Docs
API basics

API Reference

A REST API for sending and receiving email.

Base URL

https://post-waves.com

All requests use HTTPS and JSON. The paths, payloads and errors match Resend's API, so the official SDKs work by changing the base URL.

Authentication

Create a key in API keys and send it as a bearer token on every request:

Authorization: Bearer pw_xxxxxxxxx

Try it

Every endpoint page has a Try it panel. Paste an API key once (it stays in this browser only), then send real requests and see the live response. IDs returned by a create call are filled in automatically on the next page you visit.

Tip: use delivered@postwave.test as the recipient while testing. Nothing is emailed and you can see the full event flow.

Responses

Successful responses return 200 with a JSON body. List endpoints return { "object": "list", "data": [...] }. Errors return a status code and { statusCode, name, message }; see Errors.

Idempotency

Pass an Idempotency-Key header on POST /emails and POST /emails/batch to make retries safe for 24 hours.

Endpoints

Was this page helpful?Send feedback