---
title: "POST /api/v1/integrations/pearl/webhook"
method: POST
path: "/api/v1/integrations/pearl/webhook"
tags: ["Consulting", "Integrations"]
---

# POST /api/v1/integrations/pearl/webhook

`POST /api/v1/integrations/pearl/webhook`

Receives signed Pearl expert messages with raw-body signature verification.

## Headers

- `x-pearl-api-signature` string, required

## Request body

- object
  - `expert` object
    - `AvatarUrl` string, uri
    - `JobDescription` string
    - `Name` string
  - `message` string, required
  - `messageDateTime` string, date-time
  - `sessionId` string, uuid, required

## Response `200`

Message accepted.

- object
  - `status` 'complete', required

## Other responses

- `400` — The Pearl payload is invalid.
- `401` — The Pearl signature is invalid.
- `404` — The Pearl session is unknown.
- `429` — The verified Pearl session exceeded the webhook rate limit.
- `503` — Pearl admission controls are unavailable.

---

[API](https://skmtc.dev/expertschat/apis/billing-core-api.md) · [All operations](https://skmtc.dev/expertschat/apis/billing-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/expertschat/billing-core-api/revisions/c6d0e986ce32/schema)