v1

latestOpenAPI 3.1.02026-08-063776831.4 MB
Practitioner

Associate practitioner with group locations

Associates a practitioner with one or more locations within a group following the roster ingestion pattern. Use this same endpoint to add new location associations or to edit existing ones (e.g. update group practice location NPI(s)). Creates or updates GroupPractitionerLocation relationships and optionally TenantGroupLocationPractitionerNetwork relationships for location-specific networks. Each location's locationData may include 'npi' as a single string or array of strings.

post/practitioners/{practitionerId}/groups/{groupId}/locations

Path parameters

groupIdstring required

ID of the group

practitionerIdstring required

ID of the practitioner (certify practitioner ID)

Headers

tenant-idstring

Request body

groupIdstring required

tenantGroupId (ID of the group to which the practitioner belongs)

Example request

{
  "groupId": "group-123",
  "locations": [
    {
      "tenantGroupLocationId": "loc-123"
    }
  ]
}

Response

Successfully associated practitioner with group locations

tenantGroupPractitionerIdstring

ID of the tenant group practitioner

groupIdstring

ID of the group

Example response

{
  "tenantGroupPractitionerId": "tgp-456",
  "groupId": "group-123",
  "locations": [
    {
      "tenantGroupLocationId": "loc-123",
      "groupPractitionerLocationId": "gpl-789",
      "networks": [
        {
          "networkId": "net-123",
          "tenantGroupLocationPractitionerNetworkId": "tglpn-456"
        }
      ]
    }
  ]
}