---
title: "Update the integration activation state"
method: POST
path: "/partners/integration/status"
tags: ["Partners"]
---

# Update the integration activation state

`POST /partners/integration/status`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/partners/integration/status`
- Auth: `appAuth` (a scheme the document does not define)

Update the provider status for the calling partner's integrated services on the requested branches.

## Headers

- `AgencyRef` string, required

## Request body

- UpdateIntegrationStatusRequest
  - `partnerIntegrationStatus` string, nullable
  - `partnerIntegrationStatusDescription` string, nullable

## Response `200`

Returns the applied provider status and the affected records

- UpdateIntegrationStatusResponse
  - `partnerIntegrationStatus` 'Pending' | 'Active'
  - `partnerIntegrationStatusDescription` string, nullable
  - `partnerIntegrationStatusUpdatedOn` string, date-time
  - `updatedRecordCount` integer
  - `updatedBranchIds` integer[], nullable

## Other responses

- `400`: When the request does not contain a recognised provider status
- `401`: When access has not been granted
- `404`: When no integrated services were found for the partner and requested branches

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)