---
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 single specialty to an existing group, creating a group–specialty association. Optionally also adds the specialty to a specific group location and/or network in the same request via effective-date fields (groupSpecialtyEffectiveDate, groupLocationSpecialtyEffectiveDate, networkSpecialtyEffectiveDate). Supports effective-dating at creation but not termination-dating — use POST /groups/{id}/specialties/terminate to terminate a specialty. To add or update multiple specialties in a single call use PATCH /groups/{id}/specialties.

## 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

- object

## 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/revisions/563848e0ecc0/schema)