---
title: "Create property link"
method: POST
path: "/my-organisation/property-links"
tags: ["Property Links"]
---

# Create property link

`POST /my-organisation/property-links`

This endpoint allows a user to link a property to their organisation.

Once you requested has been accepted there will a slight delay in processing the request (approximately a minute).

To confirm your request has completed you can poll Get Singular Property Link. to see if you can move onto the next step.

We recommend you don’t poll until a minute after the initial request was submitted.

Once you have confirmation your request has been processed you can then move onto uploading your evidence.

Once the property link has been approved by the VOA the user will be able to:

*   View the detailed valuation for the property
*   Submit a request to amend the details the VOA have for the property
*   Challenge the valuation

Note that:

*   The request will be processed by the VOA with human intervention. The state will be updated and is available via the view property link endpoint.

## Headers

- `Accept` 'application/vnd.hmrc.2.0+json', required

## Request body

- CreatePropertyLinkRequestSchemaJson — unresolved $ref

## Response `200`

- CreatePropertyLinkResponseSchemaJson — unresolved $ref

---

[API](https://skmtc.net/hmrc/apis/business-rates-api.md) · [All operations](https://skmtc.net/hmrc/apis/business-rates-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hmrc/business-rates-api/revisions/669a30d937df/schema)