Track email open (pixel)

Email-open tracking pixel. Looks up a sent campaign email request by unique_code and, on first view, stamps opened_at (and delivered_at if unset). Returns an image/png response so it can be embedded as an <img> in the email body — not a JSON envelope on the happy path.

Path params

ParameterTypeRequiredNotes
emailRequestUniqueCodestringRequiredIdentifier for the record you are targeting.

Auth

  • Public — no bearer token (unauthenticated campaign group; item marked noauth). Requested by the recipient's mail client when the email is opened.

Rate limit

  • 30 requests/min per IP (public).

Behaviour

  • 200 with Content-Type: image/png (tracking pixel) on success; caching disabled via Cache-Control/Pragma/Expires headers.
  • 200 JSON { status: "failed", message: "Sent email not found" } when no matching sent email request exists.
  • 200 JSON { status: "failed", message: "Something went wrong! Please try again." } on unexpected error (still 200, so the mail client renders nothing broken).
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain