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

# Voice applications

> Create voice applications and bind inbound resources to them.

A voice application groups programmable voice behavior and inbound bindings.

A voice application currently exposes:

```text theme={null}
name
ring_timeout_seconds
caller_id
status
voice_url
callback_url
```

Create one with:

```bash theme={null}
curl -sS -X POST "$LEAMOUT_API_URL/v1/voice-applications/" \
  -H "Authorization: Bearer $LEAMOUT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Main voice app","ring_timeout_seconds":30}'
```

## Bind inbound resources

A binding associates exactly one inbound resource reference with a voice application. The API accepts `phone_number_id`, `sip_domain_id`, or `subscriber_id`.

```bash theme={null}
curl -sS -X POST \
  "$LEAMOUT_API_URL/v1/voice-applications/$APP_ID/bindings" \
  -H "Authorization: Bearer $LEAMOUT_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"phone_number_id\":\"$NUMBER_ID\"}"
```

Bindings are the control-plane link used to resolve inbound traffic to application behavior.
