---
search:
  tags:
    - Events
    - POST
seo:
  description: >-
    Subscribe a URL to matching event types. With generateSecret,… Reference for
    the POST /api/v2/events/topics/{ref}/subscriptions endpoint in the Anlyon
    API.
sidebar:
  label: Create a webhook subscription
  badge: POST
title: Create a webhook subscription
type: openapi-operation
---
Subscribe a URL to matching event types. With `generateSecret`, the plaintext signing secret is returned exactly once.

`POST /api/v2/events/topics/{ref}/subscriptions`