Skip to main content
POST
/
v1
/
discovery
/
aggregator-connections
Create aggregator connection
curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/discovery/aggregator-connections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountRef": "<string>",
  "baseUrl": "<string>",
  "clientId": "<string>",
  "configName": "<string>",
  "secret": "<string>"
}
'
{
  "accountRef": "<string>",
  "baseUrl": "<string>",
  "configName": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication (format: "Bearer {token}")

Body

application/json
​
accountRef
string
required

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

Minimum string length: 1
Example:

"a1b2c3d4-5678-90ab-cdef-1234567890ab"

​
baseUrl
string<uri>
required

Vendor API base URL, stored as the connection host

Minimum string length: 1
Example:

"https://api.pluggy.ai"

​
clientId
string
required

Aggregator API client id (sealed; never emitted)

Minimum string length: 1
​
configName
string
required

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

Minimum string length: 1
Example:

"pluggy-main"

​
secret
string
required

Aggregator API client secret (sealed; never emitted)

Minimum string length: 1
​
vendor
enum<string>
required

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

Available options:
pluggy,
belvo
Example:

"pluggy"

Response

Created

​
accountRef
string
required

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

Example:

"a1b2c3d4-5678-90ab-cdef-1234567890ab"

​
baseUrl
string<uri>
required

Stored vendor API base URL

Example:

"https://api.pluggy.ai"

​
configName
string
required

Connection config name the operator mints a token against

Example:

"pluggy-main"

​
vendor
enum<string>
required

Aggregator vendor the connection is bound to

Available options:
pluggy,
belvo
Example:

"pluggy"