# Voice apps

A voice app answers calls with your own logic, hosted on your server. Voice apps are under **Voice > Voice Apps**.

To handle calls without code, see [flows.md](/md/flows.md) and [pbx-apps.md](/md/pbx-apps.md).

## Kinds

| Kind | How it works |
|---|---|
| **CoXML (markup over HTTP)** | For each call we fetch instructions from your **Voice URL**. CoXML is compatible with TwiML. |
| **Call Control (webhooks + REST)** | We send call events to your **Webhook URL**. Your server controls the call with the API. |

The kind cannot be changed after creation.

## Create an app

1. Select **Create app**.
2. Enter a **Name** and pick the **Kind**.
3. Pick the **Callback format**: **Contactivity (recommended)**, or **Twilio-compatible** for code you are moving from another provider.
4. For **CoXML**: enter the **Voice URL** and **Method**. Optionally set a **Fallback URL**, **Status callback** and **Hangup URL**.
5. For **Call Control**: enter the **Webhook URL** and optionally a **Failover URL**.
6. Select **Save**.

## Connect a number

Route a number to the app with **CoXML app** or **Call Control app**. See [route-a-number.md](/md/route-a-number.md).

## Enable and archive

Select **Disable** in the app's ⋮ menu to stop it. A disabled app rejects the calls routed to it. **Enable** turns it back on.

Archiving cannot be undone. An app that a number routes to cannot be archived. Change the routing first.

## For developers

CoXML, Call Control and the API are documented on the developer site.
