---
title: "Create a webhook subscription"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Create a webhook subscription

`POST /v1/webhooks`

Register a new webhook endpoint to receive card transaction events. The signing secret is only returned once at creation time - store it securely.

## Request body

- CreateWebhookSubscriptionSchema
  - `url` string, uri, required — HTTPS webhook endpoint URL. Must be publicly accessible and not resolve to private IP ranges.

## Response `201`

Webhook subscription created successfully. The signing_secret is only returned once.

- CreateWebhookSubscriptionResponseSchema
  - `id` string, uuid, required — Unique identifier for the webhook subscription.
  - `url` string, required — The webhook endpoint URL.
  - `created_at` string, date-time, required — When the webhook was created.
  - `updated_at` string, date-time, required — When the webhook was last updated.
  - `signing_secret` string, required — Signing secret for verifying webhook signatures. This is only returned once at creation time.

## Other responses

- `400` — Invalid request data

---

[API](https://skmtc.dev/floatfinancial/apis/float-public-api.md) · [All operations](https://skmtc.dev/floatfinancial/apis/float-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/floatfinancial/float-public-api/revisions/a3c42eb1b312/schema)