---
title: "form.response_created event"
method: POST
path: "form.response_created"
---

# form.response_created event

`POST form.response_created` (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` 'form.response_created', required
  - `created` integer, required: Unix seconds
  - `data` object, required
    - `form` object, required
      - `id` string, required
      - `title` string, required
    - `response` object, required
      - `id` string, required
      - `edition` integer, required
      - `respondentEmail` string, nullable, required
      - `createdAt` string, required: ISO 8601 timestamp (UTC)

## 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)