---
title: "Telnyx SMS webhook handler"
method: POST
path: "/webhooks/telnyx"
tags: ["Webhooks"]
---

# Telnyx SMS webhook handler

`POST /webhooks/telnyx`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/webhooks/telnyx`
- Auth: none declared

Receives inbound SMS from Telnyx with MO (Mobile Originated) filtering. Validates telnyx-signature-ed25519 header with Ed25519 signature verification. Rejects A2P spoofed messages via three-layer filtering (line type, Number Lookup API, MDR check). Responds 200 immediately, processes asynchronously.

## Response `200`

Webhook received

- SuccessResponse: Generic success response
  - `success` boolean, required
  - `message` string

## Other responses

- `401`: Invalid webhook signature
- `503`: Webhook signature verification not configured

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/b15f506de696?raw)