# Configurable activities

A configurable activity is a record in the timeline of a CRM entity with its own styling: an icon, a title, body blocks, and buttons. The `layout` structure defines its appearance. Suited for integrations that show a card for a call, request, delivery, or other external event in the timeline of a deal, lead, contact, or company.

This section covers only create, read, and update. Delete and list go through the common activities API: [`DELETE /v1/activities/:id`](/docs/entities/activities) and [`GET /v1/activities`](/docs/entities/activities).

Bitrix24 API: `crm.activity.configurable.*`
Scope: `crm`

## Operations

- [Create activity](./configurable/create.md) — `POST /v1/activity-configurable`
- [Get activity](./configurable/get.md) — `GET /v1/activity-configurable/:id`
- [Update activity](./configurable/update.md) — `PATCH /v1/activity-configurable/:id`

## When to use

- A call from external telephony appears in a deal's timeline as a card with an action button.
- A request from an external service is shown with "Confirm" and "Reject" actions.
- A delivery or external event appears in a lead's card with its own icon and link.

## OAuth application requirements

The methods work only in the context of an application: an authorization key `vibe_app_*` with a session token in the `Authorization: Bearer` header is required. A personal API key `vibe_api_*` is rejected by Bitrix24 with `ERROR_WRONG_CONTEXT`. Only the application that created an activity can modify it.

Custom activity types `crm.activity.type.*` are registered in Bitrix24 — there is no separate endpoint for them in the Vibecode API. Without its own type, an activity is created with the `CONFIGURABLE` type.

## See also

- [Activities](/docs/entities/activities)
- [Activity bindings](/docs/entities/activities/bindings)
- [Timeline log](/docs/timeline-logs)
- [Keys and authorization](/docs/keys-auth)