---
title: "Create a list of company employees"
method: POST
path: "/company-employees"
tags: ["Company Employee"]
---

# Create a list of company employees

`POST /company-employees`

## Request

- Base URL: `https://api.gupy.io/api/v1`
- URL: `https://api.gupy.io/api/v1/company-employees`
- Auth: HTTP bearer

Create a list of company employees for internal recruitment

## Request body

- CompanyEmployeePostRequest: Post request body
  - `employees` CompanyEmployeeInput[]
    - `name` string, required: Company employee name
    - `countryOfOrigin` string, required: Company employee country abbreviation (eg. BR)
    - `identificationDocument` string, required: Company employee identification document

## Response `201`

A confirmation of successful insertion of the company employees list

- CompanyEmployeePostResponse: Post response body
  - `employees` CompanyEmployee[]
    - `id` integer: Id of the Company employee
    - `name` string: Company employee name
    - `countryOfOrigin` string: Company employee country abbreviation (eg. BR)
    - `identificationDocument` string: Company employee identification document
    - `companyId` integer: Id of the Company

## Other responses

- `400`: BadRequest / Invalid Input
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/gupy/apis/gupy-public-api.md) - [All operations](https://skmtc.dev/gupy/apis/gupy-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gupy/apis/gupy-public-api/revisions/b84c14658872?raw)