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

# link.created

> Receive the current link after a short link is created.

Biqli sends `link.created` after a short link is successfully created and its database transaction commits.

Use this event to copy new links into another system, start an internal workflow, or update a search index.

## Example payload

```json theme={null}
{
  "id": "evt_01m2examplecreated0000000000",
  "event": "link.created",
  "createdAt": "2026-09-14T13:40:24+00:00",
  "data": {
    "id": "biq_lnk_01M2EXAMPLE00000000000000",
    "externalId": "campaign_1842",
    "name": "Autumn campaign",
    "url": "https://example.com/autumn",
    "shortUrl": "https://biq.li/autumn",
    "key": "autumn",
    "description": "Autumn launch",
    "active": true,
    "expiresAt": null,
    "workspaceId": "biq_ws_01M2EXAMPLE000000000000000",
    "createdAt": "2026-09-14T13:40:23+00:00",
    "updatedAt": "2026-09-14T13:40:23+00:00"
  }
}
```

## Important fields

* `data.id` is the link's stable Biqli public ID.
* `data.externalId` is your optional external identifier and can be `null`.
* `data.url` is the destination URL.
* `data.shortUrl` is the complete short URL; `data.key` is only its path key.
* `data.workspaceId` identifies the workspace that owns the link.

Store the envelope `id`, not the link ID, to deduplicate webhook deliveries. One link has one resource ID but can produce several different webhook events.