---
title: "Create aggregator connection"
method: POST
path: "/v1/discovery/aggregator-connections"
tags: ["Discovery"]
---

# Create aggregator connection

`POST /v1/discovery/aggregator-connections`

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.

## Request body

- AggregatorConnectionRequest
  - `accountRef` string, required — Opaque vendor account reference (Pluggy itemId, Belvo link id) the webhook pull threads onto its request
  - `baseUrl` string, uri, required — Vendor API base URL, stored as the connection host
  - `clientId` string, required — Aggregator API client id (sealed; never emitted)
  - `configName` string, required — Unique connection config name (tenant-scoped); the mint endpoint binds a token to this name
  - `secret` string, required — Aggregator API client secret (sealed; never emitted)
  - `vendor` 'pluggy' | 'belvo', required — Aggregator vendor: pluggy (Pluggy Open Finance aggregator) or belvo (Belvo aggregator)

## Response `201`

Created

- AggregatorConnectionResponse
  - `accountRef` string, required — Stored opaque vendor account reference (Pluggy itemId, Belvo link id)
  - `baseUrl` string, uri, required — Stored vendor API base URL
  - `configName` string, required — Connection config name the operator mints a token against
  - `vendor` 'pluggy' | 'belvo', required — Aggregator vendor the connection is bound to

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)