---
title: "Handle Number Order Status"
method: POST
path: "/public/webhooks/telnyx/orders"
tags: ["Webhooks - Telnyx"]
---

# Handle Number Order Status

`POST /public/webhooks/telnyx/orders`

Telnyx webhook for number_order.status_changed events.

Finalises or discards the pending stub created when /call-tracking/numbers
was hit with an async-resolving order. Credits are charged here (not at
request time) so nothing is billed until Telnyx confirms provisioning.

Telnyx retries on non-2xx, so errors inside handlers log-and-return 200
for anything we've already processed idempotently.

## Headers

- `telnyx-signature-ed25519` string
- `telnyx-timestamp` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/8492136eefc5/schema)
