> For the complete documentation index, see [llms.txt](https://chekin.gitbook.io/chekin-public-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chekin.gitbook.io/chekin-public-api/api-reference/guests/create-guest.md).

# Create Guest

The "Create Guest" endpoint allows for adding a new guest record to the system, capturing detailed information related to a guest's identity, contact information, and reservation details. This capability is crucial for maintaining accurate and comprehensive guest profiles, enhancing the guest experience, and facilitating efficient management

Take into account that most of the fields are optional, and other ones depend on the [Police](/chekin-public-api/api-reference/police.md) or [Stats](/chekin-public-api/api-reference/stats.md) you have configured

{% hint style="info" %}
For place fields (city of birth, province…), send codes from the field's `options_url`, not names. See [Location fields](/chekin-public-api/api-reference/guests/location-and-document-fields.md).
{% endhint %}

### **Header Parameters:**

* **Authorization** *(string) <mark style="color:red;">**\***</mark>**Mandatory***\
  Required for authentication and authorization. You'll need to include a valid token here to access the reservations

### **Body Parameters:**

The body of the request should include detailed guest information, such as:

* **name** (*string*)\
  Guest Name
* **surname** (*string*)\
  Guest Surname
* **birth\_date** (*string, date (YYYY-MM-DD)*)\
  Guest Birth Date
* **gender** (*array of objects*)\
  Including labels and values for gender identification.\
  For label you can use:

  * Male
  * Female

  For value:

  * M
  * F
* **nationality** (*object*)\
  Information about the guest's nationality, typically including a country code, alpha-3 code, and country name. This is crucial for legal, tax, and statistical purposes
* **citizenship** (*string*)\
  The guest's legal nationality or citizenship. It might be required for international travel documentation or legal compliance
* **email** (*string*)\
  Contact email of the guest. Essential for communication, booking confirmations, and service notifications
* **phone** (*array of objects*)\
  Contact phone numbers of the guest, including country code and number. Vital for direct communication or urgent contact needs
* **signature** (*string*)\
  The guest's handwritten signature, sent as a base64 data URI — for example `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB...`. The accepted image formats are `jpeg`, `jpg`, `png` and `gif`. Whether the signature is needed depends on the [Guest Schema](/chekin-public-api/api-reference/guests/guest-schema.md) returned for the reservation
* **document\_type**, **document\_number**, **document\_issue\_date**, and other document-related fields capture the details of identification documents such as passports or ID cards. These are critical for verifying the identity of the guest, meeting legal requirements, and facilitating check-ins
* **visa\_number**\
  If applicable, the visa number associated with the guest's travel documents. Important for international guests and compliance with immigration regulations
* **is\_pre\_registered** (*boolean*)\
  Indicates whether the guest has pre-registered, through our online Check-in process. Helps in streamlining the check-in process
* **has\_allianz\_insurance** (*boolean*)\
  Specifies if the guest has insurance coverage through Allianz. Relevant for travel insurance or liability coverage
* **second\_surname** (*string*)\
  In cultures or jurisdictions where individuals have more than one surname, this field captures the additional surname
* **purpose\_of\_stay**, **tax\_exemption**, and **full\_tourist\_tax**\
  Fields may relate to the reason for the guest's stay, any tax exemptions they're entitled to, and information on tourist tax, which are essential for legal and financial processing
* **residence\_country**\
  Guest residence country
* **residence\_city**\
  Guest residence city
* **residence\_address**\
  Guest residence address
* **document\_expiration\_date**, **document\_expedition\_country**\
  This is relevant legal documentation that is up to date and valid, crucial for compliance with local and international laws.
* Additional fields capture more specific details, to cater to various regulatory and operational needs.

{% openapi src="/files/2YNWdcD7SWYAbJN2lC4R" path="/guests" method="post" %}
[Chekin-Chekin-1.0.0-resolved.json](https://3564732132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfAJzL2tAGO9ZwOToBa0R%2Fuploads%2Fgit-blob-0641a0e07e27281f11fe82de446c7229bfe15c1e%2FChekin-Chekin-1.0.0-resolved.json?alt=media)
{% endopenapi %}