Add a member to a job's hiring team
Add a person to the job’s hiring team. Provide exactly one of email or organization_member; an email not yet in the organization creates a pending row. Accepts an Idempotency-Key header to make retries safe.
Authorizations
API key authentication for the public API. Pass your API key as a Bearer token.
Headers
Unique key (e.g. a UUID v4) that makes this POST safe to retry: a repeated key replays the original response instead of creating a second resource.
Path Parameters
Body
Add a member to a job's hiring team.
Provide exactly one of email or organization_member. The schema shows
both as optional because it cannot express the exclusive-or; the runtime
validate() is the real gate. An email that is not yet an org member
creates a pending row.
Email of the person to add. Provide exactly one of email or organization_member. An email not yet in the organization creates a pending row that resolves when that person joins.
1Id of an existing organization member to add. Provide exactly one of email or organization_member.
Hiring-team roles to assign to this member.
HIRING_MANAGER- Hiring managerRECRUITER- RecruiterCOORDINATOR- CoordinatorSOURCER- SourcerINTERVIEWER- InterviewerADMIN- Admin
HIRING_MANAGER, RECRUITER, COORDINATOR, SOURCER, INTERVIEWER, ADMIN Response
A hiring-team row (read shape).
organization_member is the resolved org member's id, or null for a pending
row (an email that has not yet joined the organization). email is the row's
natural key.
Email of the hiring team member. Stored lowercase for case-insensitive lookup.
Resolved org member. NULL while the email has not yet joined the organization.
Unified role types assigned to this hiring team member in the source ATS, mapped from Kombo's get_jobs job_roles[].unified_type. Empty list for non-ATS rows (e.g. creator auto-add) or roles Kombo could not map to a unified type.
HIRING_MANAGER- Hiring managerRECRUITER- RecruiterCOORDINATOR- CoordinatorSOURCER- SourcerINTERVIEWER- InterviewerADMIN- Admin
HIRING_MANAGER, RECRUITER, COORDINATOR, SOURCER, INTERVIEWER, ADMIN