> ## 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 agent endpoint create

> Create a new agent endpoint

Creates a new agent endpoint for the authenticated project.

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

> [!NOTE]
>
> Calls `POST /v1/agent/endpoint`

## Options

**--agent-id** `string` *required*

Agent ID to associate this endpoint with.

**--value** `string` *required*

Phone number in E.164 format (e.g., +12345678900).

**--environment** `string`

Environment name (default: production).

**--direction** `string` *required*

Call direction: INCOMING, OUTGOING, or `INCOMING_AND_OUTGOING`. One of `INCOMING`, `OUTGOING`, `INCOMING_AND_OUTGOING`

**--outbound-dial-type** `string`

Outbound dial type: NONE or `HTTP_REQUEST` (default: NONE). One of `NONE`, `HTTP_REQUEST`

**--outbound-dial-http-request-definition-id** `string`

ID of the HTTP request definition for outbound dialing (required when outboundDialType is `HTTP_REQUEST`).

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark agent endpoint create --agent-id <value> --value <value> --direction <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.