---
title: "Subscribe to Webhooks"
method: POST
path: "/api/v1/webhooks/subscribe/{partnerId}"
tags: ["Webhooks"]
---

# Subscribe to Webhooks

`POST /api/v1/webhooks/subscribe/{partnerId}`

Allows a partner to receive webhook notifications for the authenticated user.

## Path parameters

- `partnerId` string, required

## Request body

- object
  - `message` string, required — SIWE message obtained from /api/v1/webhooks/message/{partnerId}
  - `signature` string, required — Signature of the message by the user's wallet

## Response `200`

Successfully subscribed to partner webhooks

- object
  - `success` boolean — Whether the subscription was successful
  - `subscriptionId` string — Unique ID of the created subscription

## Other responses

- `400` — Invalid request or signature
- `401` — Authentication required
- `409` — Subscription already exists
- `500` — Internal Server Error

---

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