link.updated

{
  "type": "link.updated",
  "data": {
    "id": "lnk_2NwKq8ZmT4xLr7VbYc3HdPjF",
    "status": "active",
    "param": "ref",
    "value": "sam",
    "partner_id": "part_8fKq2LmZx7RtYw3nVbHc5dPj",
    "program_id": "prg_3hTq9WxLm2RbZk7VnYc4DsPf",
    "organization_id": "org_7YtKm3QwZ9xRb2NvHc6LdPsF",
    "created_at": "2026-08-24T14:12:07.480Z",
    "updated_at": "2026-08-24T14:12:07.480Z"
  },
  "timestamp": "2026-08-24T14:12:07.512Z"
}

{
  "type": "link.updated",
  "data": {
    "id": "lnk_2NwKq8ZmT4xLr7VbYc3HdPjF",
    "status": "active",
    "param": "ref",
    "value": "sam",
    "partner_id": "part_8fKq2LmZx7RtYw3nVbHc5dPj",
    "program_id": "prg_3hTq9WxLm2RbZk7VnYc4DsPf",
    "organization_id": "org_7YtKm3QwZ9xRb2NvHc6LdPsF",
    "created_at": "2026-08-24T14:12:07.480Z",
    "updated_at": "2026-08-24T14:12:07.480Z"
  },
  "timestamp": "2026-08-24T14:12:07.512Z"
}

Every webhook is delivered as JSON with the same envelope, link.updated carries the link in data:

string

The event name, link.updated.

object

The link this event is about.

Hide data

string

Unique id for the link.

string | null

Current state of the link, e.g. active.

string | null

The query parameter used for tracking, e.g. ref.

string | null

The parameter value that identifies the partner, e.g. sam.

string | null

Id of the partner this link belongs to.

string | null

Id of the program the link belongs to.

string

Id of the organization that owns the link.

string

When the link was created (ISO 8601).

string

When the link was last updated (ISO 8601).

string

ISO 8601 time the event was emitted.

Deliveries can carry more fields than listed here, and the example below is shortened, so ignore fields you don't use.

{
  "type": "link.updated",
  "data": {
    "id": "lnk_2NwKq8ZmT4xLr7VbYc3HdPjF",
    "status": "active",
    "param": "ref",
    "value": "sam",
    "partner_id": "part_8fKq2LmZx7RtYw3nVbHc5dPj",
    "program_id": "prg_3hTq9WxLm2RbZk7VnYc4DsPf",
    "organization_id": "org_7YtKm3QwZ9xRb2NvHc6LdPsF",
    "created_at": "2026-08-24T14:12:07.480Z",
    "updated_at": "2026-08-24T14:12:07.480Z"
  },
  "timestamp": "2026-08-24T14:12:07.512Z"
}

Getting started

Events