---
title: "ping event"
method: POST
path: "ping"
---

# ping event

`POST ping` (webhook)

Signed with `PDFBetter-Signature: t=<unix>,v1=<hex HMAC-SHA256(secret, `${t}.${body}`)>`. Respond with any 2xx within 10 seconds.

## Headers

- `PDFBetter-Signature` string, required

## Payload

- object
  - `id` string, required: evt_…; use it to de-duplicate
  - `type` 'ping', required
  - `created` integer, required: Unix seconds
  - `data` object, required
    - `endpointId` string, required
    - `message` string, required

## Acknowledgement `2XX`

Acknowledged. Anything else (or no answer in 10 s) is retried.

---

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