# Update existing customers

### Request 

<mark style="color:orange;">**POST**</mark> &#x20;

{% code overflow="wrap" %}

```url
https://interface.experience-hotel.com/api/xp-store-bookings/customers
```

{% endcode %}

```json
{
	"customers": [
		{
			"reference": "123456",
			"title": "Mr",
			"firstname": "John",
			"lastname": "Doe",
			"email": "testemail@test.com",
			"phone": "+336464848",
			"birthdate": "1982-04-23",
			"country": "FR",
			"language": "EN",
			"address_street_number_and_name": "122 Grand Street",
			"address_postal_code":"75001",
			"address_state":"Ile de France",
			"address_city": "Paris",
			"nationality":"FR",
			"identity_document_number":"1234567890",
			"extra_attributes": {
				"vip":"1"
			}
		}
	]
}
```

###

### Fields

\*Mandatory fields

#### Customer Object&#x20;

<table><thead><tr><th>Fields</th><th width="100">Type</th><th width="100">Required<select><option value="XmhIvyiVedXx" label="Required" color="blue"></option><option value="gsrOuZSZCg7T" label="Optional" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td>reference*</td><td>string</td><td><span data-option="XmhIvyiVedXx">Required</span></td><td>Unique identifier of the customer</td></tr><tr><td>title</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Title or civility of the customer </td></tr><tr><td>firstname</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Firstname of the customer</td></tr><tr><td>lastname</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Lastname of the customer</td></tr><tr><td>email</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Email of the customer</td></tr><tr><td>phone</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Phone number</td></tr><tr><td>birthdate</td><td>string ($ISO 8601)</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Birthdate of the customer</td></tr><tr><td>country</td><td>string ($ISO 3166-1 alpha-2)</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Country of the customer</td></tr><tr><td>language</td><td>string ($ISO 639-1)</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Language of the customer. If not present, the language can be deduce from the country</td></tr><tr><td>address_street_number_and_name</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Customer's address street and number</td></tr><tr><td>address_postal_code</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Customer's address postal code</td></tr><tr><td>address_state</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Customer's address state</td></tr><tr><td>address_city</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Customer's address city</td></tr><tr><td>nationality</td><td>string ($ISO 3166-1 alpha-2)</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Nationality of the customer</td></tr><tr><td>identity_document_number</td><td>string</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Number of the identity document (ID, passport)</td></tr><tr><td>extra_attributes</td><td>Object</td><td><span data-option="gsrOuZSZCg7T">Optional</span></td><td>Array of key/value to be associated to the customer (optional)</td></tr></tbody></table>

### Response

200 OK

```html
1 customers updated
```

#### <br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://experience-crm.gitbook.io/experience-crm-api/reservations/pms-api/update-existing-customers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.