> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.propertypal.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.propertypal.com/_mcp/server.

# Introduction

Welcome to the PropertyPal developer documentation. This is the home for the APIs
and integration guides you'll use to send property data to
[PropertyPal](https://www.propertypal.com).

## Commercial Listings API

The **Commercial Listings API** lets you upload, update, retrieve, and remove
commercial property listings for display on PropertyPal. It's designed for
**commercial agents** and **feed providers** integrating with the PropertyPal
platform.

Browse every endpoint, schema, and example.

### Rightmove 2.0 compatibility

The API is intentionally **backwards-compatible with Rightmove's V2 Commercial
API**. If your system already publishes commercial stock to Rightmove using their
V2 feed, you can re-point that integration at PropertyPal with minimal changes —
generally just the base URL, the OAuth token endpoint, and your credentials.

Path shapes, request/response schemas, field names, enum values, and validation
rules all follow the Rightmove V2 contract. The two implementations are
independent, and there are a few intentional differences where the PropertyPal
way is more flexible for partners:

* **Branch ID** can be a string *or* an integer (Rightmove allows integers only),
  so you can reuse the branch IDs you already send to other portals.
* **New branches** can be pushed immediately without pre-registration — listings
  become visible once the branch is mapped to a PropertyPal account by support.
* **Validation is less strict.** Anything Rightmove accepts, PropertyPal accepts;
  the reverse isn't guaranteed. Acceptance by the API doesn't guarantee the
  property appears on the site — a separate secondary process performs additional
  checks.

This API manages **commercial** listings only. Residential stock should continue
to be uploaded via PropertyPal's existing residential feed routes.

## Get started

Contact the PropertyPal Feeds Team to receive your OAuth2 `client_id` and
`client_secret`.

Exchange your credentials for an access token. See
[Authentication](/docs/authentication).

Send your first property with a `PUT` to the Commercial Listings API. See the
[API reference](/api-reference/overview).

## Need help?

For access credentials or onboarding support, contact the PropertyPal Feeds Team
at [help@propertypal.com](mailto:help@propertypal.com).