> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# email.clicked

> A tracked link in mail a workflow or sequence sent was 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

```json theme={null}
{
  "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"
  }
}
```

<ResponseField name="messageId" type="string" required>
  Custral's tracking id for the send (`snd_…`), the same id its
  [opens](/dev/webhooks/events/email-opened) carry. Always present.
</ResponseField>

<ResponseField name="url" type="string">
  Where the link goes, as it was written in the email.
</ResponseField>

<ResponseField name="recordId" type="string">
  The record the workflow or sequence run was about. Absent when the send was
  not tied to a record.
</ResponseField>

## 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`](/dev/webhooks/events/email-sent).
* **Only automated sends.** Links in mail sent from the inbox composer do not
  fire this event.

## Example

```ts theme={null}
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",
  });
});
```


## Related topics

- [Email](/dev/webhooks/events/email.md)
- [email.sent](/dev/webhooks/events/email-sent.md)
- [Event catalog](/dev/webhooks/events/overview.md)
- [Webhooks](/dev/webhooks/overview.md)
- [Recurring events](/comms/calendar/recurring-events.md)