Click tracking

GET /api/t/{token} Records the click, then redirects to the target URL. Any failure path — unknown token, malformed URL, database down — redirects to a neutral page instead. Same principle: never a 500 in a mail that has already left.

Authorization

Role in the organizationThis endpoint
OWNERAllowed
ADMINAllowed
MEMBERAllowed
A key carries the role its creator holds in this organization — never a role on AgentsMail itself. See API keys.

Path parameters

ParameterTypeDescription
tokenstringRequired. Opaque, per recipient and per send. It is generated for you and travels inside the email

Example

bash
curl -i "https://www.agentsmail.io/api/t/$TOKEN"

Response

  • 200 OK — the call succeeded.
  • 401 Unauthorized — missing or invalid key, or its owner left the organization.
  • 404 Not Found — no such resource, or it belongs to another organization. The API never confirms that an id exists to a caller who has no right to it.
  • 429 Too Many Requests — over 120 requests in a minute for this key.