v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB
Discovery

Mint an aggregator webhook token

Mints a webhook token bound to an existing aggregator connection and returns the raw token plus its provider-facing webhook URL ONCE. Only the token's SHA-256 hash is stored.

post/v1/discovery/webhooks/tokens

Request body

connection_config_namestring required

Config name of the existing aggregator connection the token binds to

vendor'pluggy' | 'belvo' required

Aggregator vendor the token is minted for: pluggy (Pluggy) or belvo (Belvo)

Example request

{
  "connection_config_name": "pluggy-main",
  "vendor": "pluggy"
}

Response

Created

tokenstring required

Raw bearer token, surfaced exactly once; only its SHA-256 hash is stored server-side

vendor'pluggy' | 'belvo' required

Aggregator vendor the token is bound to

webhook_urlstring required

Fully-formed provider-facing receiver URL embedding the raw token in its path segment; configure this in the vendor dashboard

Example response

{
  "vendor": "pluggy"
}