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.

  1. Sign up with no key and no email: POST https://p.didtheyopen.com/signup. Store agent_key once. Give the owner dashboard_login_key, dashboard_url, and manage_key in a private channel.
  2. MCP: connect https://p.didtheyopen.com/mcp (Streamable HTTP) with header Authorization: Bearer <agent key>.
  3. REST: create a pixel with POST /v1/messages, then poll GET /v1/events or register POST /v1/webhooks with 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

Limits and errors

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.