# Timeline entries

Create, read, and delete log entries in a CRM entity's timeline. A log entry is a structured event that appears in a card's history (deal, lead, contact, company, smart process) as a message from an application with a title and text.

Bitrix24 API: `crm.timeline.logmessage.*`
Scope: `crm`

## Operations

- [Create an entry](./logs/create.md) — `POST /v1/timeline-logs`
- [List entries](./logs/list.md) — `GET /v1/timeline-logs`
- [Get an entry](./logs/get.md) — `GET /v1/timeline-logs/:id`
- [Delete an entry](./logs/delete.md) — `DELETE /v1/timeline-logs/:id`

## Typical scenario

1. Create an entry in the parent entity's timeline: [`POST /v1/timeline-logs`](./logs/create.md). Get the `id` of the created entry.
2. Optionally — pin it ([`POST /v1/timeline-logs/:id/pin`](/docs/timeline-logs/pins/pin)), bind it to several entities ([`POST /v1/timeline-logs/:id/bind`](/docs/timeline-logs/bindings/bind)), add a note ([`POST /v1/timeline-logs/:id/note`](/docs/timeline-logs/notes/save)).
3. View the entity's log: [`GET /v1/timeline-logs?entityTypeId=...&entityId=...`](./logs/list.md).

## See also

- [CRM Timeline](/docs/timeline-logs) — section overview, full AI agent example
- [Notes](/docs/timeline-logs/notes) — comments on a log entry
- [Pins](/docs/timeline-logs/pins) — pin/unpin
- [Bindings](/docs/timeline-logs/bindings) — link an entry to additional entities