---
title: "Create a contract and legal entity ID"
method: POST
path: "/partners/invite"
tags: ["Manage contracts"]
---

# Create a contract and legal entity ID

`POST /partners/invite`

Use this endpoint to create a partner card for a new partner and invite them to sign a contract with Booking.com

## Headers

- `Authorization` string

## Request body

- object
  - `city` string — City name of the partner company.
  - `company_name` string, required — Commercial name of the company. Use the partner name if a commercial name is not available.
  - `contract_countries` string[] — List of country codes where the partner has properties.
  - `country` string — Country code of the partner company.
  - `is_test` 0 | 1 — Indicates whether to create a test partner. Set to 1 for test partners, 0 for production partners.
  - `legal_contact_email` string, required — Contact email of the partner. This is treated as the unique identifier for the partner.
  - `legal_contact_name` string, required — Contact name of the person authorized to sign.
  - `legal_contact_phone_number` string — Contact phone number of the partner.
  - `legal_name` string — Legal name of the company used for official registration. Use the partner name if a legal name is not available.
  - `preferred_language` string, required — The partner's preferred language code for communication.
  - `street` string — Street name of the partner company.
  - `total_number_of_properties` integer — Total number of properties that the partner has.
  - `website` string — Website of the partner, if any.
  - `zipcode` string — Zipcode of the partner company.

## Response `200`

OK

- object
  - `data` InvitedPartnerObject, required
    - `legal_entity_id` integer, required — The unique legal entity ID of the partner.
  - `errors` object[]
    - `code` string, required — Alphanumeric identifier for warning/error.
    - `details` object, required — Additional details of warning/error.
    - `message` string, required — English-language description of warning/error.
  - `meta` object, required
    - `ruid` string, required — Response Unique Identifier. Refer to this when talking to Booking.com Connectivity Support.
  - `warnings` object[]
    - `code` string, required — Alphanumeric identifier for warning/error.
    - `details` object, required — Additional details of warning/error.
    - `message` string, required — English-language description of warning/error.

## Other responses

- `201` — Created
- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/booking/apis/contracting-api.md) · [All operations](https://skmtc.net/booking/apis/contracting-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/contracting-api/revisions/558b23bebdcd/schema)