---
agentTools:
  projectIndex: https://developers.getbyrd.com/llms.txt
---

# Removed the V2 returns announce endpoint

`POST /v2/returns/announce` has been removed. Announcing a return is now done
with `POST /v3/returns/announce`, described in
[Announcing returns](https://developers.getbyrd.com/docs/announcing-returns).

Calls to the old path answer `405 Method Not Allowed`, not `404`. If your
integration still posts to `/v2/returns/announce`, its return announcements are
not reaching byrd and no return labels are being issued for them.

Migrating requires three changes to your request:

* the path is now `/v3/returns/announce`
* request fields are `snake_case`, for example `shipment_id` instead of
  `shipmentID`
* `courier` is a new required field

See [Announcing returns](https://developers.getbyrd.com/docs/announcing-returns) for the full field list and the
accepted carrier identifiers.