v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB

Discovery

Create aggregator connection

Creates an Open-Finance data-aggregator (Pluggy/Belvo) connection and seals its credential. The connection's config name is what the webhook token-mint endpoint binds a token to. The supplied credential is sealed before persistence and is never returned.

post/v1/discovery/aggregator-connections

Request body

accountRefstring required

Opaque vendor account reference (Pluggy itemId, Belvo link id) the webhook pull threads onto its request

baseUrlstring uri required

Vendor API base URL, stored as the connection host

clientIdstring required

Aggregator API client id (sealed; never emitted)

configNamestring required

Unique connection config name (tenant-scoped); the mint endpoint binds a token to this name

secretstring required

Aggregator API client secret (sealed; never emitted)

vendor'pluggy' | 'belvo' required

Aggregator vendor: pluggy (Pluggy Open Finance aggregator) or belvo (Belvo aggregator)

Example request

{
  "accountRef": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "baseUrl": "https://api.pluggy.ai",
  "configName": "pluggy-main",
  "vendor": "pluggy"
}

Response

Created

accountRefstring required

Stored opaque vendor account reference (Pluggy itemId, Belvo link id)

baseUrlstring uri required

Stored vendor API base URL

configNamestring required

Connection config name the operator mints a token against

vendor'pluggy' | 'belvo' required

Aggregator vendor the connection is bound to

Example response

{
  "accountRef": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "baseUrl": "https://api.pluggy.ai",
  "configName": "pluggy-main",
  "vendor": "pluggy"
}