Create a new group for the tenant
POST/groups
Creates a new group record scoped to the requesting tenant. The request body must supply at least one of npi or externalGroupId; email is validated and returns 400 if malformed, but no other fields are currently enforced by request validation (schema validation is disabled for this endpoint). Not idempotent — repeated calls with identical payloads create duplicate group records. Note: the parentHealthcareOrgId query parameter is currently accepted but has no effect on the created group regardless of the value supplied.
Request
Responses
- 201
- 400
- 401
- 403
- 500
Group successfully created
Invalid request body — neither npi nor externalGroupId was supplied, or email failed format validation
Unauthorized - Authentication required
Forbidden - Insufficient permissions
Internal server error during request processing (e.g., network timeout, etc.)