---
title: "Subscribe a Zap (register webhook target)"
method: POST
path: "/integrations/zapier/hooks/subscribe"
tags: ["Zapier"]
---

# Subscribe a Zap (register webhook target)

`POST /integrations/zapier/hooks/subscribe`

Registers a Zapier `hookUrl` for the authenticated user. The access token
must include the `contacts:read` scope. On success, returns a subscription `id`
that Zapier will later pass to **DELETE** for unsubscription.

## Request body

- SubscribeRequest
  - `hookUrl` string, uri, required — Zapier's webhook target URL for this user+Zap.

## Response `200`

Subscription created or updated.

- SubscribeResponse
  - `id` string, required — Subscription identifier to use when unsubscribing.

## Other responses

- `400` — Bad request (e.g., missing/invalid `hookUrl` or content-type).
- `401` — Invalid or missing Bearer token.
- `403` — Insufficient scope (`contacts:read` required).
- `500` — Server error while creating subscription.

---

[API](https://skmtc.net/reachr/apis/reachr-api-documentation.md) · [All operations](https://skmtc.net/reachr/apis/reachr-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reachr/reachr-api-documentation/versions/e4f548c8685b/schema)