---
title: "POST /idp-group-mappings/{app_resource_id}/groups/{group_id}"
method: POST
path: "/idp-group-mappings/{app_resource_id}/groups/{group_id}"
tags: ["idp-group-mappings"]
---

# POST /idp-group-mappings/{app_resource_id}/groups/{group_id}

`POST /idp-group-mappings/{app_resource_id}/groups/{group_id}`

Creates or updates an individual `IdpGroupMapping` object (upsert operation).

**Behavior:**
- If the mapping doesn't exist, it will be created with the provided values
- If the mapping exists, only the fields provided in the request will be updated

## Path parameters

- `app_resource_id` string, uuid, required
- `group_id` string, uuid, required

## Request body

- object
  - `alias` string, nullable — Optional alias for the group mapping
  - `hidden_from_end_user` boolean, nullable — Whether this mapping should be hidden from end users. - **New mappings**: If not provided, defaults to `false` - **Existing mappings**: If not provided, existing value is preserved (no change) - **Explicit values**: If provided, value is updated to the specified boolean

## Response `200`

The IDP group mapping was successfully created or updated.

- IdpGroupMapping — Information about a group mapping.
  - `app_resource_id` string, uuid — The ID of the app resource.
  - `group_id` string, uuid, required — The ID of the group.
  - `alias` string — The alias of the group.
  - `hidden_from_end_user` boolean, required — A bool representing whether or not the group is hidden from the end user.

---

[API](https://skmtc.net/opal/apis/opal-api.md) · [All operations](https://skmtc.net/opal/apis/opal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opal/opal-api/versions/13b58df96d40/schema)