---
title: "Register a webhook for new responses"
method: POST
path: "/api/v1/hooks"
tags: ["Hooks"]
---

# Register a webhook for new responses

`POST /api/v1/hooks`

## Request

- Base URL: `https://api.formbuilder.com`
- URL: `https://api.formbuilder.com/api/v1/hooks`
- Auth: HTTP bearer

Requires hooks:manage and responses:read. FormBuilder POSTs event response.created to target_url for eligible new responses. Omit form_id for all owned forms. Delivery rechecks current token authorization and response eligibility. Keep callback URLs private; receivers should authenticate by retrieving the current response and deduplicate by response ID.

## Request body

- object
  - `target_url` string, uri, required
  - `form_id` string
  - `event` 'response.created'

## Response `201`

Created

## Other responses

- `400`: Error

---

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