---
title: "Create and invite a new membership"
method: POST
path: "/v2/memberships/invite_employee_or_accountant"
tags: ["Memberships"]
---

# Create and invite a new membership

`POST /v2/memberships/invite_employee_or_accountant`

OAuth scope: `membership.write`

---

Create a new membership and invite it to the authenticated organization. This endpoint allows to create a new member and invite them into the organization into a team which is defined in the request. Once the endpoint is called correctly, the new member is created and the user receives an invitation email. In this email, the user will receive instructions on how to activate the membership and join the authenticated organization’s Qonto account.

## Headers

- `X-Qonto-Staging-Token` string

## Request body

- object
  - `membership` object, required
    - `email` string, email — email of the person being invited to join the organization
    - `first_name` string — first name of the person being invited to join the organization
    - `last_name` string — last name of the person being invited to join the organization
    - `role` 'reporting' | 'employee' — role of the person being invited to join the organization
    - `team_id` string, uuid — unique identifier of the team the new membership is being assigned

## Response `200`

returns a created membership

- object
  - `membership` object
    - `id` string, uuid — the membership's id
    - `first_name` string — the first name of the membership being invited to join the organization
    - `last_name` string — the last name of the membership being invited to join the organization
    - `email` string — the email address of the membership being invited to join the organization
    - `role` 'reporting' | 'employee' — the set of permissions of the membership within the organization's account
    - `locale` string — the language chosen by the membership being invited to join the organization
    - `team_id` string, uuid — the team id to which the membership has been assigned

## Other responses

- `401` — returns an unauthorized error
- `403` — returns a forbidden error
- `422` — returns an unprocessable entity error

---

[API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/revisions/25208d6f9deb/schema)