> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pinnacle.sh/v-2/webhooks/user-events/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pinnacle.sh/_mcp/server.

# User Events

POST 

Receive events related to user interactions such as when a user starts typing via webhook. See our [guide](/guides/messages/receiving) for handling user and message events with SDKs.

> **Note:** Typing indicators are best-effort hints. RBM may coalesce, drop, or skip indicators, and you may not receive an indicator for every keystroke or session. Events can be missed if messages arrive before typing events are processed.


Reference: https://docs.pinnacle.sh/webhooks/user-events

## Request

### Headers

- `PINNACLE-SIGNING-SECRET` (string, required) — Secret for verifying the authenticity of the request. Starts with `pss-` and is unique for each webhook. Find it at [webhooks](https://app.pinnacle.sh/dashboard/development/webhooks).

### Payload

- `type` (enum, required) — Type of user event.
  - Allowed values: `USER.TYPING`
- `startedAt` (string, required) — Timestamp when the user event started in ISO 8601 format.
- `conversation` (UserEventConversation, required) — Conversation metadata containing the conversation ID, sender, and recipient information.

## Types

### UserEventConversation

Conversation metadata containing the conversation ID, sender, and recipient information.

- `id` (string, required) — Unique identifier for the conversation. This identifier is a string that always begins with the prefix `conv_`, for example: `conv_1234567890`.  To get more conversation details, use the [POST /conversations/get](/api-reference/conversations/get) endpoint.
- `from` (string, required) — Phone number of the user who triggered the event.
- `to` (string, required) — Agent ID that the user is interacting with.

> One API for RCS, iMessage, MMS, and SMS. Build, test, and scale every channel — send your first message in minutes, not weeks.