> ## 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 http-request-definition create

> Create HTTP request definition

Creates a new HTTP request definition. The signing secret is only returned in this response and cannot be retrieved later.

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

> [!NOTE]
>
> Calls `POST /v1/http-request-definition`

## Options

**--scope** `string` *required*

Scope: `AGENT_OUTBOUND_DIAL`. One of `AGENT_OUTBOUND_DIAL`

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

URL for the HTTP request.

**--description** `string`

Description of the HTTP request definition.

**--method** `string`

HTTP method (default: POST). One of `POST`, `PUT`, `PATCH`, `GET`

**--body** `string`

Request body template. Accepts a JSON object or a string with placeholders like \{\{phoneNumberToDial}}. Objects are serialized to JSON for storage.

**--headers** `object`

Request headers as key-value pairs.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark http-request-definition create --scope <value> --url <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.