GET
/
v2
/
webhook_subscriptions
/
{id}
Get a webhook subscription
curl --request GET \
  --url https://thirdparty.qonto.com/v2/webhook_subscriptions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "membership_id": "123e4567-e89b-12d3-a456-426614174000",
  "callback_url": "https://api.partner.com/webhooks/qonto",
  "types": [
    "v1/transactions",
    "v1/accounts",
    "v1/organizations",
    "v1/memberships",
    "v1/consent-revocations",
    "v1/cards"
  ],
  "description": "Production webhook for transactions",
  "created_at": "2025-01-24T10:55:00Z",
  "updated_at": "2025-01-24T10:55:00Z"
}

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 length: 512
Example:

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

​
types
enum<string>[]
required

The types of events to subscribe to

Minimum length: 1
Example:
[
  "v1/transactions",
  "v1/accounts",
  "v1/organizations",
  "v1/memberships",
  "v1/consent-revocations",
  "v1/cards"
]
​
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 length: 256
Example:

"Production webhook for transactions"