# Property API overview

Use the Property API to create or update a property and its details. You can also add or remove property settings.

## Supported actions using Property API

The following table summarises the tasks, the HTTP method and the endpoints that the API supports.

| Endpoint | Task | HTTP Method |
|  --- | --- | --- |
| `property-api/properties` | Create a property. | POST |
| `property-api/properties/{{propertyID}}` | Update/Overwrite existing property details. | PATCH |
| `property-api/properties/{{propertyID}}` | Retrieve property details. | GET |
| `property-api/properties/{{propertyID}}/settings` | Create or update property settings details. | POST |
| `property-api/properties/{{propertyID}}/settings` | Retrieve property settings details. | GET |


## What can you do with Property Details API

The following are the benefits of using the `property-api`:

- Create or update a property's details such as name, property category, check in/out time and physical location without impacting other information.
- Edit the property location by changing the property's latitude and longitude values.
- Specify an external property ID while creating a property. This could be the ID of the property within your system and may be useful for you while you're debugging or testing your integration.
- Create a [property ID](#what-can-you-do-with-property-ids) quickly by providing minimum information. Add the rest of the details later using other endpoints.
- See an improved request and response body structure in Json.
- Get familiar with the validation checks for [property creation](/connectivity/docs/property-api/implementing-property-api-ga/#api-validations) and [property updates](/connectivity/docs/property-api/implementing-property-api-ga/#api-validations-1) early.


For more details on the Property Details API, see [Managing property details.](/connectivity/docs/property-api/implementing-property-api-ga)

### What can you do with Property IDs?

Once you have created a property ID, you can use it to:

- Add or update additional property details such as:
  - Property contact information
  - Facilities and room amenities
  - Room details including occupancy and bedding, and
  - Taxes and fees information
- Retrieve property details either using the Property Details API or the `OTA_HotelDescriptiveInfo` endpoint.
- Check whether a property is ready to be set to open and bookable.


## Quick Actions

→ To create and manage property details, see [Managing property details.](/connectivity/docs/property-api/implementing-property-api-ga)
→ To learn more about the Property API use cases, see [Property API implementation use cases.](/connectivity/docs/property-api/property-api-usecases/)
→ To troubleshoot Property API errors, see [Troubleshooting Property API error responses.](/connectivity/docs/property-api/troubleshooting-property-api/)
→ To learn more about the Contacts API, see [Introduction to Contacts API.](/connectivity/docs/contacts-api/contacts-api-introduction/)

## Going live

Before you go live with your API integration, you'll need to meet certain requirements. For more information, see [Going Live.](/connectivity/docs/going_live/)