---
title: "Disconnect a carrier"
method: DELETE
path: "/v1/connections/carriers/{carrier_name}/{carrier_id}"
tags: ["carrier_accounts"]
---

# Disconnect a carrier

`DELETE /v1/connections/carriers/{carrier_name}/{carrier_id}`

## Request

- Base URL: `https://api.shipengine.com`
- URL: `https://api.shipengine.com/v1/connections/carriers/{carrier_name}/{carrier_id}`
- Auth: API key in header `API-Key`

Disconnect a carrier

## Response `204`

The request was successful.

- string

## Other responses

- `404`: The specified resource does not exist.
- `500`: An error occurred on ShipStation API's side. > This error will automatically be reported to our engineers.

## Changes

- **2026-10-22** `e998dffc42be`: 6 warning
  - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `404`
  - added the new `bring_your_own_label_not_supported` enum value to the `errors/items/error_code` response property for the response status `500`
  - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `404`
  - added the new `multiple_sales_orders` enum value to the `errors/items/error_code` response property for the response status `500`
  - …2 more
- **2026-10-09** `020f57d6f5b8`: 2 breaking, 16 info
  - the `errors/items/` response's property type changed from no type to `object` for status `404`
  - the `errors/items/` response's property type changed from no type to `object` for status `500`
  - added the optional property `errors/items/carrier_code` to the response with the `404` status
  - added the optional property `errors/items/carrier_code` to the response with the `500` status
  - …14 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/shipstation/apis/shipengine-api/changes/v1/connections/carriers/:carrier_name/:carrier_id/delete.md)

---

[API](https://skmtc.dev/shipstation/apis/shipengine-api.md) - [All operations](https://skmtc.dev/shipstation/apis/shipengine-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shipstation/apis/shipengine-api/revisions/5d4d1c20776b?raw)
