---
title: "hiringTeam.addMember"
method: POST
path: "/hiringTeam.addMember"
tags: ["Hiring Team"]
---

# hiringTeam.addMember

`POST /hiringTeam.addMember`

Adds an Ashby user to the hiring team at the application, job, or opening level.

**Requires the [`organizationWrite`](authentication#permissions-hiringteamaddmember) permission.**

## Request body

- union
  - object
    - `applicationId` string, uuid, nullable, required — The application to assign the user a role on
    - `jobId` string, uuid, nullable — The job to assign the user a role on
    - `openingId` string, uuid, nullable — The opening to assign the user a role on
    - `teamMemberId` string, uuid, required — The id of the user to assign the role to
    - `roleId` string, uuid, required — The id of the hiring team role to assign
  - object
    - `applicationId` string, uuid, nullable — The application to assign the user a role on
    - `jobId` string, uuid, nullable, required — The job to assign the user a role on
    - `openingId` string, uuid, nullable — The opening to assign the user a role on
    - `teamMemberId` string, uuid, required — The id of the user to assign the role to
    - `roleId` string, uuid, required — The id of the hiring team role to assign
  - object
    - `applicationId` string, uuid, nullable — The application to assign the user a role on
    - `jobId` string, uuid, nullable — The job to assign the user a role on
    - `openingId` string, uuid, nullable, required — The opening to assign the user a role on
    - `teamMemberId` string, uuid, required — The id of the user to assign the role to
    - `roleId` string, uuid, required — The id of the hiring team role to assign

## Response `200`

Responses from the hiringTeam.addMember endpoint

- union
  - HiringTeamAddMemberSuccessResponse
    - `success` true, required
    - `results` HiringTeamRole[], required — The hiring team roles after the member is added
      - `userId` string, uuid, required — The unique identifier of the hiring team member
      - `firstName` string, required — The first name of the hiring team member
      - `lastName` string, required — The last name of the hiring team member
      - `email` string, email, required — The primary email address of the hiring team member
      - `role` string, required — The hiring team role assigned to the member
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)
