# Pins

Pinning a log entry to the top of a CRM entity's timeline. Pinned entries are always visible when a deal, lead, contact, or company card is opened — regardless of how many events appeared later.

Bitrix24 API: `crm.timeline.item.pin/unpin`
Scope: `crm`

## Operations

- [Pin an entry](./pins/pin.md) — `POST /v1/timeline-logs/:id/pin`
- [Unpin an entry](./pins/unpin.md) — `POST /v1/timeline-logs/:id/unpin`

## Typical scenario

1. Create an important log entry: [`POST /v1/timeline-logs`](/docs/timeline-logs/logs/create).
2. Pin it so it stays at the top: [`POST /v1/timeline-logs/:id/pin`](./pins/pin.md). The manager will see it every time the card is opened.
3. When the event is no longer relevant — unpin it: [`POST /v1/timeline-logs/:id/unpin`](./pins/unpin.md).

## See also

- [CRM timeline](/docs/timeline-logs) — section overview
- [Log entries](/docs/timeline-logs/logs) — creating entries that can later be pinned
