---
title: "Invite employee"
method: POST
path: "/api/v1/employees/invite"
tags: ["Employees"]
---

# Invite employee

`POST /api/v1/employees/invite`

## Request

- Base URL: `https://api-business.wirexapp.com`
- URL: `https://api-business.wirexapp.com/api/v1/employees/invite`
- Auth: API key in header `Authorization`

Invites a new employee to the corporation with personal data, manager address, and residence address.

## Request body `*/*`

- RequestEmployeesInviteRequest
  - `department` string: Optional employee department
  - `email` string, required: Email address of the employee
  - `first_name` string, required: Employee first name
  - `job_title` string: Optional employee job title
  - `last_name` string, required: Employee last name
  - `manager_address` string: Optional employee manager address
  - `phone` string: Optional employee phone number
  - `residence_address` RequestEmployeeResidenceAddressRequest
    - `city` string
    - `country` string
    - `line1` string
    - `line2` string
    - `postal_code` string
    - `state` string
  - `role_id` string, required: Role id assigned to employee

## Response `200`

OK

- ResponseEmptyResponse

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api.md) - [All operations](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wirexapp/apis/wirex-corporate-baas-api/revisions/6525bfbc8f99?raw)