***

title: userEvent
slug: /reference/typescript/rest/calling/user-event
description: Send custom user-defined events on an active call via REST.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

Send a custom user-defined event on an active call. User events allow you
to pass arbitrary data between call control applications and event handlers.
Listeners registered for user events on the RELAY side will receive the
payload you send here.

<EndpointSchemaSnippet endpoint="POST /api/calling/calls" />

## **Response Example**

<EndpointResponseSnippet endpoint="POST /api/calling/calls" />

## **Example**

```typescript {9}
import { RestClient } from "@signalwire/sdk";

const client = new RestClient({
  project: "your-project-id",
  token: "your-api-token",
  host: "your-space.signalwire.com"
});

await client.calling.userEvent("call-id-xxx", {
  event: { action: "order.confirmed", order_id: "ORD-12345", amount: 49.99 },
});
```