---
title: "Add a specialty to a group"
method: POST
path: "/groups/{id}/specialties"
tags: ["Group"]
---

# Add a specialty to a group

`POST /groups/{id}/specialties`

Adds a new specialty to an existing group. Optionally can also add the specialty to a specific group location.

## Path parameters

- `id` string, required

## Headers

- `tenant-id` string

## Request body

- CreateGroupSpecialtyRequest
  - `tenantSpecialtyId` string, required — ID of the tenant specialty
  - `groupSpecialtyEffectiveDate` string — Effective date for the group specialty (YYYY-MM-DD)
  - `groupSpecialtyIsPrimary` boolean, required — Indicates if the specialty is primary
  - `tenantGroupLocationId` string — ID of the tenant group location (optional)
  - `groupLocationSpecialtyEffectiveDate` string — Effective date for the group location specialty (YYYY-MM-DD)
  - `groupLocationSpecialtyIsPrimary` boolean — Indicates if the location specialty is primary
  - `tenantGroupNetworkId` string — ID of the tenant group network (optional)
  - `networkSpecialtyEffectiveDate` string — Effective date for the network specialty (YYYY-MM-DD)
  - `networkSpecialtyIsPrimary` boolean — Indicates if the network specialty is primary

## Response `201`

Group specialty successfully created

- JsonNode
  - `empty` boolean
  - `valueNode` boolean
  - `containerNode` boolean
  - `missingNode` boolean
  - `array` boolean
  - `object` boolean
  - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
  - `pojo` boolean
  - `number` boolean
  - `integralNumber` boolean
  - `floatingPointNumber` boolean
  - `short` boolean
  - `int` boolean
  - `long` boolean
  - `float` boolean
  - `double` boolean
  - `bigDecimal` boolean
  - `bigInteger` boolean
  - `textual` boolean
  - `boolean` boolean
  - `null` boolean
  - `binary` boolean

## Other responses

- `400` — Invalid request body or missing required parameters
- `404` — Group not found with the given ID for tenant
- `500` — Internal server error during request processing

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/versions/3d27e9019c7b/schema)