GET /api/v1/people/{personId}/commercial-owner
Read commercial responsibility. All access is scoped to the school bound to the credential.
Authenticate with Authorization: Bearer YOUR_API_KEY. Owner/admin, a Head of Sales for a sales contact of the team, or a closer/coach who can read this contact. A platform role alone grants no access; other school members are refused. Agent credentials have the same business rules.
personId: contact UUID in this school.
curl -X GET 'https://www.cohorte.io/api/v1/people/{personId}/commercial-owner' \
-H 'Authorization: Bearer YOUR_API_KEY'
200 on success. 400 invalid input, 401 invalid credential, 403 unavailable scope, 409 conflicting intention or invitation state. A response never grants access by itself.
The envelope contains success, data and correlationId. personId identifies the canonical contact. closerUserId is the responsible closer or null. Reads also return name; writes return replayed. An alias uses its canonical contact’s responsibility.
{
"success": true,
"data": {
"personId": "00000000-0000-4000-8000-000000000003",
"closerUserId": null,
"name": null
},
"correlationId": "00000000-0000-4000-8000-000000000003"
}
Use MCP get_person_commercial_owner with the same business input. Mutations require explicit operator intent. Invitation acceptance is human-only and has no MCP tool.
A sent email is distinct from an accepted invitation and from a ready closer. Disabled or failed email delivery is reported honestly; resend is explicit. New contacts are assigned to the closer of their first booking only when unassigned. If A owns a contact and B receives its call, A remains responsible and B sees only the call. Only an owner, an admin or a Head of Sales transfers responsibility, and a transfer never changes the closer of existing bookings. Historical ambiguous contacts remain unassigned and require an owner decision. Removing membership removes its commercial assignments, preserving contact history.
Personal draft hours do not activate a closer or enroll them in booking links. Owner/admin explicitly adopts prepared hours and selects booking links. Your personal IANA time zone defines your hours and exception dates, including after school configuration. Changing it preserves the entered wall-clock hours and never moves existing bookings. Travelling or changing the school time zone does not change it. Owner/admin adoption copies both the hours and their time zone. Calendar connection is optional.
