---
title: "Subscribe to form completions"
method: POST
path: "/connect/hooks"
tags: ["Integrations"]
---

# Subscribe to form completions

`POST /connect/hooks`

## Request

- Base URL: `https://api.clipform.io/v1`
- URL: `https://api.clipform.io/v1/connect/hooks`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://api.clipform.io/oauth/authorize`, token URL `https://api.clipform.io/oauth/token`, scopes: `webhooks:manage`)
  - HTTP bearer

Registers a target URL that receives the form.completed payload for every form in the connected workspace.

## Request body

- object
  - `targetUrl` string, uri, required: HTTPS endpoint Clipform POSTs each completion to. Must be publicly resolvable.

## Response `201`

Subscription created, or an existing subscription for the same URL reactivated.

- object
  - `id` string, uuid: Subscription id - pass it to the unsubscribe operation.

## Other responses

- `400`: targetUrl is missing or is not a safe public URL.
- `403`: The credential is missing the webhooks:manage scope.

---

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