---
title: "Provider data delivery"
method: POST
path: "/api/v1/integration/webhook/{token}/"
tags: ["Webhooks"]
---

# Provider data delivery

`POST /api/v1/integration/webhook/{token}/`

## Request

- Base URL: `https://api.sahha.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sahha.ai/api/v1/integration/webhook/{token}/`
- Auth: API key in header `Authorization`

Called by the provider, not by clients of ours. The token in the URL is the endpoint's credential and identifies the integration; each provider adapter then validates its own signature. Bodies are provider-specific and capped at 10 MiB.

Answers 200 for anything a redelivery cannot fix — unknown token, bad signature, unparseable payload — because re-sending the same thing buys nothing and costs a retry storm. 503 is reserved for the one case worth redelivering: the payload was good and this service could not take it.

## Path parameters

- `token` string, required

## Request body

- object

## Response `200`

Accepted, or rejected in a way a redelivery would not fix.

## Other responses

- `400`: Empty token.
- `503`: Accepted-but-unstorable: the queue or database was unreachable. The provider should redeliver.

---

[API](https://skmtc.dev/sahha/apis/sahha-platform-v1.md) - [All operations](https://skmtc.dev/sahha/apis/sahha-platform-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/sahha/apis/sahha-platform-v1/revisions/c7f918b46707?raw)