> For the complete documentation index, see [llms.txt](https://experience-crm.gitbook.io/experience-crm-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://experience-crm.gitbook.io/experience-crm-api/reservations/pms-api/update-existing-customers.md).

# 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>