---
title: "Invite Cardholder"
method: POST
path: "/cardholders/invite"
tags: ["Cardholders"]
---

# Invite Cardholder

`POST /cardholders/invite`

Invite a new [cardholder](/docs/cardholder-entity) to Pliant. An invite email to the provided email address will be triggered, and the [cardholder](/docs/cardholder-entity) needs to register with Pliant using our registration flow. This means the [cardholder](/docs/cardholder-entity) is able to use Pliant web and mobile apps once fully registered. You will receive a callback once the [cardholder](/docs/cardholder-entity) is fully registered and can be used.

## Request body

- object
  - `organizationId` string, uuid, required — The ID of the organization.
  - `salutation` 'MR' | 'MRS' — Used mainly for email communication
  - `firstName` string, required — The first name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
  - `lastName` string, required — The last name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
  - `email` string, required — The email address of the cardholder. This will be used for email communication.
  - `phoneNumber` string — Phone number must start with `+` followed by 8 to 15 numbers, e.g. `+49123456789`.
  - `language` 'en' | 'de' | 'es' | 'fi' | 'fr' | 'it' | 'pt' | 'nl' | 'et' | 'el' | 'lv' | 'lt' | 'sk' | 'sl' | 'pl', required — Used for setting the language in Pliant apps as well as for email communication.
  - `isOwner` boolean, required — If you want to invite the first owner (during onboarding and before authorization was granted) please use the endpoint POST `/cardholders/invite-owner`.
  - `dateOfBirth` string, date, nullable — The date-of-birth of the cardholder.
  - `nationality` string, nullable — The nationality of the cardholder (ISO 3166-1 alpha-2).
  - `personalAddress` object, nullable — The personal address of the cardholder.
    - `country` string, nullable — The country of the address in ISO 3166-1 alpha-2 notation.
    - `city` string, nullable — The city of the address.
    - `postalCode` string, nullable — The postal code of the address. Must match the country-specific format (e.g. 5 digits for `DE`/`FR`/`ES`, 4 digits for `AT`/`BE`). Both `postalCode` and `country` must be provided together.
    - `streetName` string, nullable — The street name of the address.
    - `streetNumber` string, nullable — The street number of the address.
    - `additionalInformation` string, nullable — Optional additional address information.
  - `deliveryAddress` object, nullable — The delivery address of the cardholder.
    - `country` string, nullable — The country of the address in ISO 3166-1 alpha-2 notation.
    - `city` string, nullable — The city of the address.
    - `postalCode` string, nullable — The postal code of the address. Must match the country-specific format (e.g. 5 digits for `DE`/`FR`/`ES`, 4 digits for `AT`/`BE`). Both `postalCode` and `country` must be provided together.
    - `streetName` string, nullable — The street name of the address.
    - `streetNumber` string, nullable — The street number of the address.
    - `additionalInformation` string, nullable — Optional additional address information.

## Response `201`

Cardholder is in creation process, wait for the callback to use it.

- 0 — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) · [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getpliant/pliant-customer-api/revisions/f3f589cfa718/schema)