---
title: Add new destination to an existing access group
canonical: https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/access-group/add-new-destination-to-an-existing-access-group/
product: CloudConnexa Docs
---

# Add new destination to an existing access group

`POST /api/v1/access-groups/{id}/destination`

Destinations can be defined as specific resources or as all resources of a certain type (including both existing and newly created ones).

Examples:

1. **All Networks**

```
"destination": [
  {
    "type": "NETWORK_SERVICE",
    "allCovered": true
  }
],
```

This configuration grants the access group sources access to all networks, including their applications and IP services.

1. **Specific Network**

```
"destination": [
  {
    "type": "NETWORK_SERVICE",
    "parent": "00000000-0000-0000-0000-000000000001",
    "allCovered": true
  }
],
```

This configuration grants the access group sources access to a specific network with ID `00000000-0000-0000-0000-000000000001`, including its applications and IP services.

1. **Specific Application/IP Service within a Network**

```
"destination": [
  {
    "type": "NETWORK_SERVICE",
    "parent": "00000000-0000-0000-0000-000000000001",
    "children": ["00000000-0000-0000-0000-000000000002"]
    "allCovered": true
  }
],
```

This configuration grants the access group sources access to a specific application or IP service with ID `00000000-0000-0000-0000-000000000002` within a network with ID `00000000-0000-0000-0000-000000000001`

## Body parameter

```json
{
  "type": "USER_GROUP",
  "allCovered": true,
  "parent": "00000000-0000-0000-0000-000000000000",
  "children": [
    "00000000-0000-0000-0000-000000000000"
  ]
}
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| id | path | string | true | Access group ID |
| body | body | [AccessItemDestinationRequest](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/schemas/accessitemdestinationrequest.md) | true | none |
| » type | body | string | false | none |
| » allCovered | body | boolean | false | none |
| » parent | body | string | false | none |
| » children | body | \[string\] | false | none |

### Enumerated Values

| Parameter | Value |
| --- | --- |
| » type | USER\_GROUP |
| » type | NETWORK\_SERVICE |
| » type | HOST\_SERVICE |
| » type | PUBLISHED\_SERVICE |

## Responses

| Status | Meaning | Description | Schema |
| --- | --- | --- | --- |
| 200 | [OK](https://tools.ietf.org/html/rfc7231#section-6.3.1) | OK | [AccessGroupResponse](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/schemas/accessgroupresponse.md) |

To perform this operation, you must be authenticated by means of one of the following methods: oauth

---

Prev: [Remove source from an existing access group](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/access-group/remove-source-from-an-existing-access-group.md)
Next: [Remove destination from an existing access group](https://openvpn.net/cloud-docs/developer/cloudconnexa-api-v1-2-3/access-group/remove-destination-from-an-existing-access-group.md)
Index: https://openvpn.net/cloud-docs/llms.txt