Email open tracking API for AI agents

Updated 18 November 2026

Short answer: one call creates a pixel, one tag goes in the email, and opens come back through a cursor-based feed or HMAC-signed webhooks. Agents can sign themselves up with POST /signup. The same account is also available as a remote MCP server at https://p.didtheyopen.com/mcp. The full instructions an agent should follow are at agent.md (guide version 7).

This page is the endpoint overview. For the Gmail or Outlook send path, see the Gmail and Outlook guides. For what an open means, see How accurate is email open tracking?.

Base URL and auth

The calls

Insert exactly this tag at the end of the HTML body, before </body>:

<img src="PIXEL_URL" alt="" width="1" height="1" border="0" style="display:block;width:1px;height:1px;border:0;overflow:hidden">

One pixel per email. Do not convert plain-text emails to HTML just to carry it.

Example

curl -X POST https://p.didtheyopen.com/v1/messages \
  -H "Authorization: Bearer $DIDTHEYOPEN_API_KEY" \
  -H "Idempotency-Key: proposal-dana-1" \
  -H "Content-Type: application/json" \
  -d '{"client_ref":"proposal-dana-1","sender_label":"work","label":"Dana Levi"}'

The 201 response includes pixel_url. After sending, poll GET /v1/events?since=<next_since>&summary=1 and tell the owner only when insight.notable is true.

Trial, errors and privacy

New accounts get 25 tracked emails free, with no card. Then Personal is $9/month (up to 300 tracked emails a day) or Developer is $29/month (up to 2,000 a day). A tracked message and its opens are deleted after 30 days by default, or sooner if you set a shorter expiry, from when the message is created. When the trial is used up, POST /v1/messages returns 402 payment_required with checkout links; send the email untracked and tell the owner once.

Other errors: 401 bad key · 403 wrong scope · 409 client_ref_exists · 409 idempotency_conflict · 429 quota_exceeded (daily cap, wait for 00:00 UTC) · 429 rate_limited / signups_full · 503 storage unavailable (retry later with the same client_ref). Every error is { "error": { "code", "message" } }.

No recipient addresses, subjects, content or IP addresses are stored.

Questions

Is there an OpenAPI file?

Yes. The API reference is at /docs and the OpenAPI document is at /openapi.json. agent.md is the integration guide; GET /v1/me tells you when that guide has a new version.

Do I have to host a webhook?

No. If you have no public HTTPS endpoint, pull the scheduled feed every 10 to 15 minutes. Webhooks are the push path, and they need a manage key to register.

Can the agent sign itself up?

Yes. POST /signup needs no email. The agent stores the agent key and gives the owner the dashboard login and manage key once, in a private channel.