{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/carriers/disconnect-carrier","default":false,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/docs/carriers/disconnect-carrier","default":true,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/carriers/disconnect-carrier","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml","oas-apis/@shipstation-v2/openapi.yaml":"oas-apis/@shipstation-v2/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","openapi-code-sample","openapi-response-sample"]},"type":"markdown"},"seo":{"title":"Disconnect a Carrier","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":["apis/@shipengine/docs/ltl/**","apis/@shipengine/docs/reference/register-stamps.md","apis/@shipengine/docs/carriers/amazon-buy-shipping.md","apis/@shipengine/docs/elements/elements-guide.md","apis/@shipengine/docs/partners/getting-started.md","apis/@shipengine/docs/reference/connect-order-sources.md","apis/@shipengine/docs/sales-orders/get-started-with-orders.md"]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"disconnect-a-carrier","__idx":0},"children":["Disconnect a Carrier"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can programmatically disconnect any carrier you have ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connect-carriers"},"children":["connected to your ShipStation API account"]}," using the DELETE method with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/connections/carriers/"]}," endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You may want to do this if you no longer use the services of the connected carrier account, or if you wish to use the same account but with a different ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]},". For the latter case, you would disconnect the carrier from your account and then reconnect it."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Plan availability"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Disconnecting a carrier through the API is available on ShipStation API (ShipEngine) plans only. It is not available to ShipStation accounts."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The unique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," of the connected carrier you wish to disconnect."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_name"]}," for that carrier, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ups"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fedex"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dhl_express"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/list-carriers"},"children":["list carriers"]}," to find both the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_name"]}," you need. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," is especially important if you have multiple accounts for the same carrier."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Before Disconnecting a Carrier"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If your carrier requires manifesting, you must ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/creating-manifests"},"children":["manifest open shipments"]}," for that carrier ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["before"]}," disconnecting it from your ShipStation API account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you have any previously created labels under this carrier connection that you still wish to void, you must do so prior to disconnecting the carrier account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you reconnect a disconnected carrier account, the new connection will have a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request--response","__idx":2},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["DELETE /v2/connections/carriers/{carrier_name}/{carrier_id}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/openapi/connections/disconnect_carrier"},"children":["Disconnect a carrier"]}," API reference for the full endpoint details."]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-apis/@shipstation-v2/openapi.yaml","operationId":"disconnect_carrier","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"OpenApiResponseSample","attributes":{"descriptionFile":"oas-apis/@shipstation-v2/openapi.yaml","operationId":"disconnect_carrier"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a carrier has been successfully disconnected, you will receive an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP 204 No Content"]}," status."]}]},"headings":[{"value":"Disconnect a Carrier","id":"disconnect-a-carrier","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Example Request & Response","id":"example-request--response","depth":2}],"frontmatter":{"slug":"/disconnect-carrier","seo":{"title":"Disconnect a Carrier"}},"lastModified":"2026-11-10T23:25:07.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/disconnect-carrier","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}