Skip to main content
GET
Get a webhook subscription

Authorizations

Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Path Parameters

id
string<uuid>
required

Response

Webhook subscription retrieved successfully

id
string<uuid>
required

Unique identifier for the webhook subscription

Example:

"123e4567-e89b-12d3-a456-426614174000"

organization_id
string<uuid>
required

ID of the organization that owns this subscription

Example:

"123e4567-e89b-12d3-a456-426614174000"

membership_id
string<uuid>
required

ID of the membership that owns this subscription

Example:

"123e4567-e89b-12d3-a456-426614174000"

callback_url
string<uri>
required

The HTTPS URL where webhooks will be sent

Maximum string length: 512
Pattern: ^https://.*
Example:

"https://api.partner.com/webhooks/qonto"

types
enum<string>[]
required

The types of events to subscribe to

Minimum array length: 1
Available options:
v1/transactions,
v1/accounts,
v1/organizations,
v1/memberships,
v1/consent-revocations,
v1/cards,
v1/payment-links,
v1/payment-links-connections,
v1/beneficiaries,
v1/client-invoices,
v1/terminal-payments,
v1/clients,
v1/products
Example:
created_at
string<date-time>
required

When the subscription was created

Example:

"2025-01-24T10:55:00Z"

updated_at
string<date-time>
required

When the subscription was last updated

Example:

"2025-01-24T10:55:00Z"

description
string

Optional description for the webhook subscription

Maximum string length: 256
Example:

"Production webhook for transactions"