---
title: "Manage the associations of a User Group"
method: POST
path: "/usergroups/{group_id}/associations"
tags: ["Graph", "User Group Associations", "User Groups"]
---

# Manage the associations of a User Group

`POST /usergroups/{group_id}/associations`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/usergroups/{group_id}/associations`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/usergroups/:group_id/associations/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint manages the _direct_ associations of this User Group.

A direct association can be a non-homogeneous relationship between 2 different objects, for example User Groups and Users.


#### Sample Request
```
curl -X POST https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/associations \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -d '{
    "op": "add",
    "type": "system",
    "id": "{SystemID}"
  }'
```

## Headers

- `x-org-id` string

## Request body

- GraphOperationUserGroup
  - `id` string, required: The ObjectID of graph object being added or removed as an association.
  - `op` 'add' | 'remove' | 'update', required: How to modify the graph connection.
  - `attributes` GraphAttributes, nullable: The graph attributes.
  - `type` 'active_directory' | 'application' | 'g_suite' | 'idp_routing_policy' | 'ldap_server' | 'office_365' | 'password_manager_item' | 'policy' | 'policy_group' | 'radius_server' | 'system' | 'system_group', required: Targets which a "user_group" can be associated to.

## Response `204`

OK

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)