Open tracking for the email your agent already sends from your Gmail or Outlook.
didtheyopen tells an AI agent when the emails it sends from its owner's Gmail, Outlook or any HTML-capable path get opened, on what kind of device, and how many times. The agent adds a 1x1 pixel to each email it wants tracked and hears back through a signed webhook or a scheduled feed, so it can tell its owner unprompted: "Dana opened the proposal 3 times. Latest on an iPhone. No reply yet." Only opens worth telling are reported, and automatic loads by Apple Mail or security software are labeled, never counted as opens. Setup is one prompt to the agent, or the remote MCP server at p.didtheyopen.com/mcp. 25 tracked emails free, then $9/month Personal or $29/month Developer. No recipient addresses, subjects, content or IPs are stored, and a tracked message and its opens are deleted 30 days by default after the message is created, or sooner if you set a shorter expiry.
Quickstart
Base URL https://p.didtheyopen.com. Say "opened", never "read". An open means
the tracking image was loaded.
-
Sign up with no key and no email:
POST https://p.didtheyopen.com/signup. Storeagent_keyonce. Give the ownerdashboard_login_key,dashboard_url, andmanage_keyin a private channel. -
MCP: connect
https://p.didtheyopen.com/mcp(Streamable HTTP) with headerAuthorization: Bearer <agent key>. -
REST: create a pixel with
POST /v1/messages, then pollGET /v1/eventsor registerPOST /v1/webhookswith the manage key.
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"}'
Connect an agent
The hosted server is https://p.didtheyopen.com/mcp. Nothing to install.
Claude and other MCP clients can use this config. Replace the key after signup.
{
"mcpServers": {
"didtheyopen": {
"type": "http",
"url": "https://p.didtheyopen.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_AGENT_KEY"
}
}
}
}
Auth
Send Authorization: Bearer dto_<c|r|m|a>_<keyid>_<secret>.
a is the agent key (create and read). m is manage, and manage
includes read. Keys in the query string are rejected with
400 credential_in_url. Unknown JSON fields are rejected on the routes that
check them. Bodies are limited to 1 MB. Responses send
Cache-Control: no-store.
Endpoints
POST /signup
No key. 201 returns agent_key, manage_key, and
dashboard_login_key, each once.
POST /signup
201
{"owner_id":"o_…","agent_key":"dto_a_…","manage_key":"dto_m_…","dashboard_login_key":"dtl_…","api_base":"https://p.didtheyopen.com","dashboard_url":"https://p.didtheyopen.com/dash/login","guide_url":"https://didtheyopen.com/agent.md?v=7","caps":{"message_cap_per_day":25,"events_cap_per_message":200,"events_cap_per_day":1000,"default_expiry_days":30,"max_expiry_days":30},"note":"Keys are shown once."}
GET /healthz
No auth. Body is the text ok.
GET /v1/me
Any key. Plan, trial left, caps, today's usage, checkout links, and guide.
{"owner_id":"o_…","key_id":"…","scopes":["create","read"],"plan":"trial","trial_remaining":25,"can_create":true,"checkout":null,"manage_url":null,"guide":{"version":7,"url":"https://didtheyopen.com/agent.md?v=7"}}
POST /v1/messages
Scope create. Header Idempotency-Key (1 to 128). The 201 is the only place
pixel_url appears, including a replay of the same key and body.
402 payment_required when the account cannot create.
{"client_ref":"proposal-dana-1","sender_label":"work","label":"Dana Levi","expires_in_days":30}
201
{"id":"m_…","client_ref":"proposal-dana-1","label":"Dana Levi","sender_label":"work","state":"active","created_at":"2026-11-18T16:00:00Z","expires_at":"2026-12-18T16:00:00Z","event_count":0,"click_count":0,"last_event_at":null,"pixel_url":"https://p.didtheyopen.com/p/….gif"}
GET /v1/messages
Scope read. Query limit, cursor, state,
sender_label. Newest first. { items, next_cursor }.
GET /v1/messages/:id
Scope read. Message view plus insight (null before any load).
GET /v1/messages/by-ref/:client_ref
Scope read. Same shape as get by id, looked up by your reference.
GET /v1/events
Scope read. since is an ISO-8601 UTC time, unix seconds, or the
next_since cursor. summary=1 adds up to 20
summaries. A bad since is 400 invalid_since.
{"items":[{"id":"e_…","received_at":"2026-11-18T16:05:00Z","classification":"image_request","classifier_version":5,"client_family":"iphone_ipad","load_label":"opened","kind":"open","message_id":"m_…","client_ref":"proposal-dana-1","label":"Dana Levi","sender_label":"work"}],"next_since":"r1","has_more":false,"guide_version":6}
GET /v1/messages/:id/events
Scope read. Newest first. expand=assessment adds assessment on
each item and load_summary on the page. Only load_label
opened counts as an open.
POST /v1/messages/:id/links
Scope create. {"urls":["https://…"]}, 1 to 50, each at most 2048
characters. tracked_url is null for mailto and unsubscribe. Nothing is
stored.
{"links":[{"url":"https://example.com/proposal","tracked_url":"https://p.didtheyopen.com/c/m_…/0/…"},{"url":"mailto:dana@example.com","tracked_url":null}]}
GET /c/:message_id/:index/:sealed
No auth. 302 to the destination, or 400 HTML if the link is not valid. Not an open redirect.
GET /p/:token.gif
No auth. Always 200 image/gif, 43 bytes. A load is recorded only for a
known, active, unexpired token within caps.
PATCH /v1/messages/:id
Scope manage. {"state":"paused"} and/or
expires_in_days (shorten only). Returns the message view.
DELETE /v1/messages/:id
Scope manage. 204, no body.
POST /v1/suppressions/check
Scope create or read. {"hashes":["<sha256 hex>"]} (1 to 50). Response
{"suppressed":false}. Hashes are not returned.
GET /v1/suppressions
Scope manage. { items: [{ id, kind, note, created_at }] }. Hashes are never
returned.
POST /v1/suppressions
Scope manage.
{"kind":"address","value_hash":"<sha256 hex>","note":""}. 201 returns
id, kind, note, created_at.
DELETE /v1/suppressions/:id
Scope manage. 204.
GET /v1/webhooks
Scope manage. Lists url, enabled, failures, and timestamps. No secret.
POST /v1/webhooks
Scope manage. {"url":"https://agent.example/hook"}. 201 includes
secret once. At most 5 per owner.
PATCH /v1/webhooks/:id
Scope manage. {"enabled":true} re-enables a webhook and resets its failure
count.
DELETE /v1/webhooks/:id
Scope manage. 204.
POST /v1/webhooks/:id/test
Scope manage. Sends a type: "test" delivery. Response
{"delivered":true}.
GET /v1/webhooks/:id/deliveries
Scope manage. Last 100 deliveries with status, attempts,
last_status, and next_attempt_at.
GET /billing/checkout/:plan
Signed link from /v1/me or a 402 body (owner and
sig). 303 to checkout. HTML pages for a bad link, too many attempts, or a
failure.
POST /billing/polar
Payment webhook. A bad signature is 403. Unconfigured billing is 503. Agents do not call this.
GET /dash/billing/portal
Signed-in dashboard session. 303 to a short-lived portal session, or 302 to login when signed out.
POST /mcp
Hosted MCP, Streamable HTTP, one JSON-RPC message per request. Without a key,
initialize, tools/list, and didtheyopen_signup
work. A wrong key is 401. GET and DELETE are 405.
MCP tools
didtheyopen_signup: create an account. Not a repeatable call.-
didtheyopen_track_email: pixel, and tracked links when you pass them. didtheyopen_check_email: one email, read only.didtheyopen_new_opens: feed since a cursor, read only.didtheyopen_account: plan and usage, read only.
Limits and errors
-
API key: 120 requests per 60 seconds.
Retry-After: 60onrate_limited. - Signup: 3 per 60 seconds per address, and 100 new accounts per UTC day by default.
- Pixel and click images: 60 per 60 seconds per address.
- Trial: 25 tracked emails total, and 25 a day. Personal: 300 a day. Developer: 2,000 a day.
-
Daily message cap:
429 quota_exceededwithRetry-After: 3600. -
Errors are
{"error":{"code","message"}}. Codes includeunauthorized401,forbidden403,not_found404,payment_required402,invalid_body,unknown_field,invalid_json,invalid_cursor,invalid_since,invalid_limit,invalid_filter,credential_in_url,idempotency_conflict,client_ref_exists,message_inactive,clicks_unavailable,storage_unavailable.
Classifications: image_request, possible_proxy,
possible_scanner, missing_data. Load labels:
opened, prefetch_likely, mpp_unknown,
unknown. Only opened is an open.
Privacy and support
Privacy policy: https://didtheyopen.com/privacy. Support: support@didtheyopen.com.
Machine-readable description: /openapi.json. Agent guide: /agent.md. Short index: /llms.txt.