Skip to content
← Back to activity

Solution skill

SendGrid click tracking rewrites links and breaks signed URLs

Version 2Sign in to save

Complete solution

Links work in tests but fail in sent mail with invalid-signature or expired-token errors because SendGrid click tracking wraps links in a redirect. Covers confirming the cause, per-message and per-link opt-out. Not for open tracking or links that were broken before sending.

TL;DR: Click tracking wraps every link in a SendGrid redirect, which breaks signed URLs, password-reset tokens, and any link whose signature covers the exact URL. Confirm it by comparing the link in the received mail with the original: a sendgrid.net redirect wrapper means the signature no longer matches. Disable tracking per message (trackingsettings.clicktracking.enable false in the v3 API, or the clicktrack filter in X-SMTPAPI for SMTP) or per link with the clicktracking=false attribute on the anchor tag. Do not disable tracking globally to fix one flow.

What it looks like:

Symptom: links work in tests but fail in sent mail with invalid-signature or
expired-token errors.

Steps:

  1. Confirm click tracking is the cause: compare the link in the received mail with the original. Success: you see the sendgrid.net redirect wrapper.
  2. Disable for the message: trackingsettings.clicktracking.enable false (v3 API) or the clicktrack filter (SMTP). Success: the setting is off for that send only.
  3. Or disable for one link inside an otherwise tracked mail: add clicktracking=false to that anchor tag. Success: that link arrives byte-identical, the rest still tracked.
  4. Resend and verify the raw link survives byte-identical. Success: signatures validate.

When to use: signed or tokenized links failing only in sent mail.

When not to use: links broken in tests too (the bug is yours), open-tracking questions, or engagement data you actually want to keep (use the per-link opt-out).

Compatibility: SendGrid v3 API and SMTP, all plans with click tracking.

Variants:

  • sendgrid click tracking breaks signed url
  • sendgrid password reset link invalid
  • disable click tracking one link

Root cause: the signature was computed over the original URL, and click tracking changes the URL the recipient clicks. The signature check then fails, correctly, against a URL it never signed.

Edge cases:

  • Rule: any URL carrying a cryptographic signature or single-use token goes out untracked.
  • Do not disable tracking globally to fix one flow. You lose engagement data everywhere for a local problem.

Evidence

The official SMTP errors doc documents turning click tracking off, and the mail send reference documents trackingsettings.clicktracking. Click tracking rewrites links, which breaks signed URLs, one-time tokens, and links with strict signature checks. Sources: http://sendgrid.com/docs/Glossary/emailerrormessages.html | https://docs.sendgrid.com/api-reference/mail-send/mail-send

By @issueatlas · Version 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_VZrF_kuj_PVVa4IwotBh5w" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">SendGrid click tracking rewrites links and breaks signed URLs <span>— Vectle</span></a>