# Create Inbound Trunk Group

Creates a Trunk Group.

## Request

HTTP Method: `POST`

URI Path: `/v3/voice_in_trunk_groups`

### Request Body Object Attributes

| Name | Type | Nullable | Is Required? | Description |
| --- | --- | --- | --- | --- |
| name | `string` | No | Yes | Name of the Trunk Group. Unique among the trunks and trunk groups of the account - they share one name space. |
| external\_reference\_id | `string` | Yes | No | Optional identifier for the trunk group in the customer's external system. Maximum length is 100 characters. |
| capacity\_limit | `integer` | Yes | No | Maximum number of simultaneous calls for the Trunk Group. |

### Request Body Object Relationships

| Name | Type | Description |
| --- | --- | --- |
| voice\_in\_trunks | [To many](../../../specification/relationships.html#api-relationships) | Replaces the whole membership of the group with the trunks listed here. At most 10 distinct trunks; a trunk listed twice is counted once. |

## Examples

Simple CreateCreate and Assign Trunks

[[DIDWW-API-EXAMPLE-START]]

http

```
 1POST /v3/voice_in_trunk_groups HTTP/1.1
 2Host: api.didww.com
 3Content-Type: application/vnd.api+json
 4Accept: application/vnd.api+json
 5Authorization: Bearer [access token]
 6
 7{
 8  "data": {
 9    "type": "voice_in_trunk_groups",
10    "attributes": {
11      "name": "Main group",
12      "capacity_limit": 100
13    }
14  }
15}
```

curl

```
1curl -i -X POST https://api.didww.com/v3/voice_in_trunk_groups -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]" --data-raw '{"data": {"attributes": {"capacity_limit": 100, "name": "Main group"}, "type": "voice_in_trunk_groups"}}'
```

response

```
 1HTTP/1.1 201 Created
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "a6370df6-86db-4a1a-9a54-3742f1d8615c",
 7    "type": "voice_in_trunk_groups",
 8    "attributes": {
 9      "created_at": "2017-06-25T14:56:31.513Z",
10      "external_reference_id": null,
11      "name": "Main group",
12      "capacity_limit": 100
13    },
14    "relationships": {
15      "voice_in_trunks": {
16        "links": {
17          "self": "https://api.didww.com/v3/voice_in_trunk_groups/a6370df6-86db-4a1a-9a54-3742f1d8615c/relationships/voice_in_trunks",
18          "related": "https://api.didww.com/v3/voice_in_trunk_groups/a6370df6-86db-4a1a-9a54-3742f1d8615c/voice_in_trunks"
19        }
20      }
21    },
22    "meta": {
23      "trunks_count": 0
24    }
25  },
26  "meta": {
27    "api_version": "2026-11-19"
28  }
29}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
 1POST /v3/voice_in_trunk_groups HTTP/1.1
 2Host: api.didww.com
 3Content-Type: application/vnd.api+json
 4Accept: application/vnd.api+json
 5Authorization: Bearer [access token]
 6
 7{
 8  "data": {
 9    "type": "voice_in_trunk_groups",
10    "attributes": {
11      "name": "Main group",
12      "capacity_limit": 100
13    },
14    "relationships": {
15      "voice_in_trunks": {
16        "data": [
17          {
18            "type": "voice_in_trunks",
19            "id": "b7a9d1ce-6a89-4071-bc0d-486ee223787d"
20          },
21          {
22            "type": "voice_in_trunks",
23            "id": "7ca415f8-8342-427a-bbfc-171b995f75d6"
24          },
25          {
26            "type": "voice_in_trunks",
27            "id": "46aa9cac-a8dd-4a06-82db-cb0731e53ba0"
28          }
29        ]
30      }
31    }
32  }
33}
```

curl

```
1curl -i -X POST https://api.didww.com/v3/voice_in_trunk_groups -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]" --data-raw '{"data": {"attributes": {"capacity_limit": 100, "name": "Main group"}, "relationships": {"voice_in_trunks": {"data": [{"type": "voice_in_trunks", "id": "b7a9d1ce-6a89-4071-bc0d-486ee223787d"}, {"type": "voice_in_trunks", "id": "7ca415f8-8342-427a-bbfc-171b995f75d6"}, {"type": "voice_in_trunks", "id": "46aa9cac-a8dd-4a06-82db-cb0731e53ba0"}]}}, "type": "voice_in_trunk_groups"}}'
```

response

```
 1HTTP/1.1 201 Created
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "faea735d-ba77-40ef-bf13-f4dfc0f43a68",
 7    "type": "voice_in_trunk_groups",
 8    "attributes": {
 9      "created_at": "2017-06-25T14:56:31.513Z",
10      "external_reference_id": null,
11      "name": "Main group",
12      "capacity_limit": 100
13    },
14    "relationships": {
15      "voice_in_trunks": {
16        "links": {
17          "self": "https://api.didww.com/v3/voice_in_trunk_groups/faea735d-ba77-40ef-bf13-f4dfc0f43a68/relationships/voice_in_trunks",
18          "related": "https://api.didww.com/v3/voice_in_trunk_groups/faea735d-ba77-40ef-bf13-f4dfc0f43a68/voice_in_trunks"
19        }
20      }
21    },
22    "meta": {
23      "trunks_count": 3
24    }
25  },
26  "meta": {
27    "api_version": "2026-11-19"
28  }
29}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 422 | No | [Unprocessable Entity](../../../specification/errors/index.html#api-validation-error-object) |
| 400 | No | [Bad Request](../../../specification/errors/index.html#api-bad-request). The body carries a member the API does not accept. Also returned with the title `Quota limit reached` when the account has reached its limit of inbound trunk groups. |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 403 | No | The customer is in read-only mode. Also returned when the access token carries the `read` scope, which does not cover this method (title `Insufficient scope`, `WWW-Authenticate: Bearer error="insufficient_scope"`). See [Scopes](../../authentication.html#authentication-scopes-v35). |
| 429 | No | The request budget of the account for the current window is spent (`too_many_requests`). `Retry-After` gives the number of seconds to wait. |
