---
title: "Manage GSuite account Associations for Provider"
method: POST
path: "/providers/{provider_id}/g_suites/{gsuite_id}/associations"
tags: ["Providers", "Graph", "G Suite"]
---

# Manage GSuite account Associations for Provider

`POST /providers/{provider_id}/g_suites/{gsuite_id}/associations`

## Request

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

Creates or deletes an association between an G Suite Account and a secondary organization.
This endpoint is the core mechanism for sharing or un-sharing an integration.

The caller must belong to the owner organization (the provider's primary organization).

#### Sample Request
```
curl -X POST https://console.jumpcloud.com/api/v2/providers/{provider_id}/g_suite/{gsuite_id}/associations \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-org-id: -' \
  -H 'x-api-key: {API_KEY}' \
  -d '{
    "op": "add",
    "type": "organization",
    "id": "org-secondary-12345"
  }'
```

## Request body

- ManageAssociationsGSuiteAccount
  - `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` 'organization', required: Targets which a "organization" can be associated to.

## Response `204`

Association successfully created or deleted

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden - caller does not belong to the owner organization
- `404`: Not Found - provider, GSuite account or organization not found
- `500`: Internal Server Error

---

[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)