Skip to content

Document link metrics and who-clicked endpoints - #147

Merged
atongen merged 1 commit into
mainfrom
GG-1938-clicks-by-links
Nov 16, 2026
Merged

atongen merged 1 commit into
mainfrom
GG-1938-clicks-by-links

Conversation

@atongen

@atongen atongen commented Nov 13, 2026

Copy link
Copy Markdown
Member

Part of: https://dripcom.atlassian.net/browse/GG-1938

  • Link Metrics: the response for one email's clicks broken down by link. Each link has an opaque key, a type (url, trigger or system), unique and total clicks, share_of_clicks (what the email dashboard shows) and click_rate (unique clicks over sends)
  • Fetch link metrics: GET /v2/:account_id/metrics/email/links, by broadcast_id (the broadcast and its variations) or email_id (any email from email metrics, including Workflow and Email Series Campaign emails); activity and sent bases; owner time zone dates; 366-day range; at most 1,000 links, with links_total and links_truncated
  • List the subscribers who clicked a link: GET /v2/:account_id/metrics/email/links/subscribers, by link key, with total_count, active_count and cursor paging (limit up to 1,000)
  • Both endpoints share a 60 requests per account per hour limit, separate from email metrics; cached results do not count
  • Metrics intro points to Link Metrics

- Link Metrics: the response for one email's clicks broken down by
  link. Each link has an opaque key, a type (url, trigger or system),
  unique and total clicks, share_of_clicks (what the email dashboard
  shows) and click_rate (unique clicks over sends)
- Fetch link metrics: GET /v2/:account_id/metrics/email/links, by
  broadcast_id (the broadcast and its variations) or email_id (any
  email from email metrics, including Workflow and Email Series
  Campaign emails); activity and sent bases; owner time zone dates;
  366-day range; at most 1,000 links, with links_total and
  links_truncated
- List the subscribers who clicked a link:
  GET /v2/:account_id/metrics/email/links/subscribers, by link key,
  with total_count, active_count and cursor paging (limit up to
  1,000)
- Both endpoints share a 60 requests per account per hour limit,
  separate from email metrics; cached results do not count
- Metrics intro points to Link Metrics
@atongen atongen self-assigned this Nov 13, 2026
@atongen
atongen requested a review from a team November 13, 2026 21:28
@atongen
atongen merged commit 5a130be into main Nov 16, 2026
1 check passed
@atongen
atongen deleted the GG-1938-clicks-by-links branch November 16, 2026 17:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants