---
title: "Get Create Candidate Request Body"
method: GET
path: "/api/ats/v1/candidates/create/meta"
tags: ["Candidate"]
---

# Get Create Candidate Request Body

`GET /api/ats/v1/candidates/create/meta`

Returns the data points required to add new employee in HRIS

## Headers

- `x-connector-token` string, required

## Response `200`

Successful Response

- MetaApiResponseModel
  - `success` boolean, required
  - `data` object, nullable
  - `error` object, nullable

## Other responses

- `401` — Missing or invalid bearer authentication credentials.
- `403` — The credentials are valid but do not permit access to this resource, e.g. a connector token used on a different API category or a model whose writes are disabled.
- `422` — Validation Error
- `429` — Rate limit exceeded.

## Changes

> 11 revisions in range; 2 could not be searched.

- **2026-08-01** `eb3486b88e55` — 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`

[Change history](https://skmtc.dev/bindbee/apis/bindbee-apis/changes/api/ats/v1/candidates/create/meta/get.md)

---

[API](https://skmtc.dev/bindbee/apis/bindbee-apis.md) · [All operations](https://skmtc.dev/bindbee/apis/bindbee-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bindbee/bindbee-apis/revisions/a2669930898c/schema)