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 |
|
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 |
|
Yes |
No |
Optional identifier for the trunk group in the customer’s external system. Maximum length is 100 characters. |
capacity_limit |
|
Yes |
No |
Maximum number of simultaneous calls for the Trunk Group. |
Request Body Object Relationships#
Name |
Type |
Description |
|---|---|---|
voice_in_trunks |
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#
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}
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}
Other Responses#
Code |
Success |
Description |
|---|---|---|
422 |
No |
|
400 |
No |
Bad Request. The body carries a member the API does not accept. Also returned with the title |
401 |
No |
|
403 |
No |
The customer is in read-only mode. Also returned when the access token carries the |
429 |
No |
The request budget of the account for the current window is spent ( |