email.clicked

Fires when somebody follows a tracked link in an email sent by a workflow or a sequence. The Send email step tracks the links in the email when tracking is on, which is the default.

Payload

{
  "id": "whd_8Jd5qW3nF",
  "event": "email.clicked",
  "createdAt": "2026-09-11T10:14:03.855Z",
  "data": {
    "messageId": "snd_2Wq9rT4bLx",
    "url": "https://acme.com/pricing",
    "recordId": "rec_3Ab9xK2mQ7"
  }
}

string

required

Custral’s tracking id for the send (snd_…), the same id its opens carry. Always present.

string

Where the link goes, as it was written in the email.

string

The record the workflow or sequence run was about. Absent when the send was not tied to a record.

Worth knowing

Every click fires, including repeat clicks on the same link.
Link scanners click too. Some email security gateways follow every link in an incoming message to check it, which can fire this before the recipient has opened the email.
messageId is a tracking id. It matches the send’s opens, and does not match the provider message id on email.sent.
Only automated sends. Links in mail sent from the inbox composer do not fire this event.

Example

custral.on("email.clicked", async (event) => {
  const {url, recordId} = event.data;
  if (!recordId || !String(url).includes("/pricing")) return;

  await followUps.create({
    recordId: String(recordId),
    title: "Clicked the pricing link, follow up today",
  });
});

Getting started

Building a receiver

Event reference

Operations

Payload

Worth knowing

Example

​Payload

​Worth knowing

​Example

Payload

Worth knowing

Example