Skip to content

Manage contracts

Create, update or resend contract details.

Create a contract and legal entity ID

Request

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

Security
bearerAuth
Headers
Authorizationstring
Bodyapplication/json
citystring

City name of the partner company.

company_namestringrequired

Commercial name of the company. Use the partner name if a commercial name is not available.

contract_countriesArray of strings

List of country codes where the partner has properties.

countrystring

Country code of the partner company.

is_testinteger

Indicates whether to create a test partner. Set to 1 for test partners, 0 for production partners.

Enum:01
legal_contact_emailstringrequired

Contact email of the partner. This is treated as the unique identifier for the partner.

legal_contact_namestringrequired

Contact name of the person authorized to sign.

legal_contact_phone_numberstring

Contact phone number of the partner.

legal_namestring

Legal name of the company used for official registration. Use the partner name if a legal name is not available.

preferred_languagestringrequired

The partner's preferred language code for communication.

streetstring

Street name of the partner company.

total_number_of_propertiesinteger, (int32)

Total number of properties that the partner has.

websitestring

Website of the partner, if any.

zipcodestring

Zipcode of the partner company.

curl -i -X POST \
  https://developers.booking.com/_mock/connectivity/docs/openapispecs/contracting-api/contracting-api-specificaion/partners/invite \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "city": "Amsterdam",
    "company_name": "Parker hotels",
    "country": "nl",
    "legal_contact_email": "peter.park+test01@besthotelxyz.abc",
    "contract_countries": [
      "fr",
      "nl"
    ],
    "legal_contact_name": "Swan Park",
    "legal_contact_phone_number": "+1234567890",
    "legal_name": "Park hotels BV",
    "preferred_language": "NL",
    "street": "Streetstreet",
    "total_number_of_properties": 2,
    "zipcode": "1000AB",
    "website": "https://www.besthotelxyz.abc",
    "is_test": 1
  }'

Responses

Created

Bodyapplication/json
dataobject(InvitedPartnerObject)
errorsArray of objects(DiagnosisList)
metaobjectrequired
warningsArray of objects(DiagnosisList)
Response
{ "meta": { "ruid": "VXNlckRhdGEkYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4eXoxMjM0NTY3ODkwQUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVoxMjM0NTY3ODkw" }, "errors": [], "data": { "legal_entity_id": 22567 }, "warnings": [] }