---
title: "Deactivate a broker integration"
method: POST
path: "/integration/deactivateBrokerIntegration"
tags: ["integration"]
---

# Deactivate a broker integration

`POST /integration/deactivateBrokerIntegration`

## Request

- Base URL: `https://demo-developer.convoy.com/broker`
- URL: `https://demo-developer.convoy.com/broker/integration/deactivateBrokerIntegration`
- Auth: HTTP bearer

Deactivate a broker integration. API client credentials associated with a deactivated broker integration will no longer be able to be used to access the Convoy API.

## Headers

- `X-Convoy-API-Version` string, required

## Request body

- BrokerIntegrationDeactivateBrokerIntegrationRequest: Deactivate a broker integration request.
  - `integratorBrokerId` string, required: A unique identifier for the broker provided by the external integrator.

## Response `200`

The request has succeeded.

- BrokerIntegrationDeactivateBrokerIntegrationResponse: Deactivate a broker integration response.
  - `status` 'SUCCESS' | 'ALREADY_DEACTIVATED', required

## Other responses

- `400`: Invalid request.
- `default`: Unexpected error.

---

[API](https://skmtc.dev/convoy/apis/brokers.md) - [All operations](https://skmtc.dev/convoy/apis/brokers/llms.txt) - [OpenAPI document](https://skmtc.dev/convoy/apis/brokers/revisions/a43e2868b355?raw)