Skip to main content

method_not_allowed

You reached a real route with the wrong verb. Nothing was created, sent or charged.

Status: 405

{
  "status": 405,
  "type": "method_not_allowed",
  "message": "This method is not allowed for this path",
  "request_id": "req_01J8K2P...",
  "doc_url": "https://docs.epostix.com/errors/method_not_allowed"
}

Why you got this​

  • You sent POST to a path that only lists, or GET to one that only creates.
  • You used PUT where the endpoint expects PATCH, or the reverse.
  • A record path was called without its id, so the request landed on the collection instead.
  • A client helper defaulted to GET while the body you passed was meant for a POST.

How to fix it​

Check the verb for that exact path in the API reference and send the same body again with the correct one. The method is part of the route, so a valid path with the wrong verb never falls through to a similar endpoint.

If the path itself is wrong rather than the verb, you get not_found instead, and a URL missing the /v1 prefix lands there too.

Is it safe to retry​

No, not with the same method. The route will reject it every time. Nothing was stored, so reusing the same Idempotency-Key on the corrected request is safe.