---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/voice/api/clientconfiguration-resource#article
headline: Client Configurations resource
description: Full Twilio API reference for the Client Configurations resource used to store and manage Voice client configurations.
url: https://www.twilio.com/docs/voice/api/clientconfiguration-resource
inLanguage: en
dateModified: 2026-06-22T10:15:32.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Client Configurations resource

On this reference page, you'll learn about the parameters and properties for the Client Configurations resource, which stores Twilio Voice client configuration data such as webhook URLs. See [Related how-to documentation](#related-how-to-documentation) to learn the steps to use the info on this page.

> \[!IMPORTANT]
>
> The Client Configurations resource is currently available as a Private Beta product, and Twilio may change the information in this document at any time. This means that some features aren't yet implemented, and others may change before the product becomes Generally Available. Private Beta products aren't covered by a Service Level Agreement.

> \[!NOTE]
>
> Read more about the Call Notification feature on the [Call Notification via Webhook page](/docs/voice/sdks/client-call-notification-webhook).

## Create a Client Configuration

```bash
  curl -X POST https://voice.twilio.com/v2/Configurations/Client \
  -H "Content-Type: application/json" \
  -d '{"unique_name": "my_webhook", "description": "my webhook", "configuration": {"configurationType":"Client", "callnotification": {"url":"https://myurl.com", "method": "POST"}}}' \
  -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```

```json
{
    "account_sid": "ACxxxxxxxxxxxxxxxxxxxxx",
    "configuration": {
        "configurationType": "Client",
        "callnotification": {
            "method": "POST",
            "url": "https://myurl.com"
        }
    },
    "description": "my webhook",
    "unique_name": "my_webhook",
    "id": "voice_clientconfiguration_xxxxxxxxx"
}
```

> \[!NOTE]
>
> `unique_name` cannot contain spaces.

## Retrieve a Client Configuration

```bash
curl -X GET  https://voice.twilio.com/v2/Configurations/Client/voice_clientconfiguration_xxxxxxx \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```

```json
{
    "account_sid": "ACxxxxxxxxxxxxxxxxxxxxx",
    "configuration": {
        "configurationType": "Client",
        "callnotification": {
            "method": "POST",
            "url": "https://myurl.com"
        }
    },
    "description": "my webhook",
    "unique_name": "my_webhook",
    "id": "voice_clientconfiguration_xxxxxxxxx"
}
```

## Retrieve a list of Client Configurations

```bash
curl -X GET  "https://voice.twilio.com/v2/Configurations/Client?pageSize=1&pageToken=xxxxxxxxx" \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```

```json
{
    "content": [
        {
            "account_sid": "ACxxxxxxxxxx",
            "configuration": {
                "configurationType": "Client",
                "callnotification": {
                    "method": "POST",
                    "url": "https://myurl.com"
                }
            },
            "description": "my webhook",
            "unique_name": "my_webhook",
            "id": "voice_clientconfiguration_xxxxxxxx"
        }
    ],
    "meta": {
        "direct_token": true,
        "list_key": "content",
        "next_token": "xxxxxxx",
        "page_size": 1,
        "previous_token": "xxxxxxxxxxxxxx"
    }
}
```

> \[!NOTE]
>
> `pageSize` and `pageToken` are optional parameters.

## Update a Client Configuration

```bash
curl -X PUT https://voice.twilio.com/v2/Configurations/Client/voice_clientconfiguration_xxxxx \
-H "Content-Type: application/json" \
-d '{"unique_name": "my_updated_webhook", "configuration": {"configurationType": "Client", "callnotification": {"url":"https://my_updated_url", "method": "POST"}}}' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```

```json
{
    "account_sid": "ACxxxxxxxxxxxxxxxxxxxxx",
    "configuration": {
        "configurationType": "Client",
        "callnotification": {
            "method": "POST",
            "url": "https://my_updated_url.com"
        }
    },
    "description": null,
    "unique_name": "my_updated_webhook",
    "id": "voice_clientconfiguration_xxxxxxxxx"
}
```

> \[!NOTE]
>
> If we omit or leave a parameter value as `null` in the update request then the value will be updated to `null` or the request will result in an error.

## Delete a Client Configuration

```bash
curl -X DELETE https://voice.twilio.com/v2/Configurations/Client/voice_clientconfiguration_xxxxxx \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```

```bash
<No Content>
```

## Set a Client Configuration as the default account configuration

```bash
curl -X POST  https://voice.twilio.com/v2/Configurations/Client/Default \
-H "Content-Type: application/json" \
-d '{"configuration_id": "voice_clientconfiguration_xxxxxx"}' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```

```bash
<No Content>
```

## Retrieve the default Client Configuration for the account

```bash
curl -X GET  https://voice.twilio.com/v2/Configurations/Client/Default \
$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```

```json
{
    "account_sid": "ACxxxxxxxxxxxxxxxxxxxxx",
    "configuration": {
        "configurationType": "Client",
        "callnotification": {
            "method": "POST",
            "url": "https://myurl.com"
        }
    },
    "description": "my webhook",
    "unique_name": "my_webhook",
    "id": "voice_clientconfiguration_xxxxxxxxx"
}
```

## Unset the default Client Configuration

```bash
curl -X DELETE  https://voice.twilio.com/v2/Configurations/Client/Default \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```

```bash
<No Content>
```

## Related how-to documentation

Find how-to documentation for the topics on this page.

* [Make Twilio API requests](/docs/usage/requests-to-twilio)
  * To learn more about this API, see the [Programmable Voice API overview](/docs/voice/api)