> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark webhook create

> Create webhook

Creates a new webhook with event subscriptions. The signing secret is only returned in this response.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark webhook create [options]
```

> [!NOTE]
>
> Calls `POST /v1/webhook`

## Options

**--url** `string` *required*

Webhook URL.

**--description** `string`

Webhook description.

**--headers** `object`

Request headers (e.g. authorization tokens).

**--events** `array` *required*

Event types to subscribe to (at least one required). One of `CALL_ANALYSIS_COMPLETED`, `CALL_ANALYSIS_FAILED`, `CALL_ANALYSIS_CANCELLED`, `CALL_EVALUATION_COMPLETED`, `CALL_EVALUATION_FAILED`, `SIMULATION_RUN_PLAN_JOB_STARTED`, `SIMULATION_RUN_PLAN_JOB_COMPLETED`, `SIMULATION_RUN_PLAN_JOB_FAILED`, `SIMULATION_RUN_PLAN_JOB_CANCELLED`, `SIMULATION_JOB_STARTED`, `SIMULATION_JOB_COMPLETED`, `SIMULATION_JOB_FAILED`, `SIMULATION_JOB_CANCELLED`, `METRIC_COLLECTION_JOB_COMPLETED`, `METRIC_COLLECTION_JOB_FAILED`, `CHAT_ANALYSIS_COMPLETED`, `CHAT_ANALYSIS_FAILED`, `ISSUE_OPENED`, `ISSUE_RESOLVED` Repeatable.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark webhook create --url <value> --events <value>
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.