Mint aggregator consent token

Use this endpoint to get the consent token that the aggregator’s own consent widget (Pluggy Connect or the Belvo widget) needs for this connection. The request has no body: Matcher reads the vendor from the stored connection. For a connection already bound to a vendor item or link, the token starts a re-consent. After the end customer completes the widget, bind the item or link id to the connection with an update that sets accountRef. This route does not deduplicate retries. Resending it, even with the same X-Idempotency key, mints another token.

POST /v1/discovery/aggregator-connections/{id}/connect-token

Mint aggregator consent token

cURL

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/discovery/aggregator-connections/{id}/connect-token \
  --header 'Authorization: Bearer <token>'

201

Example

{
  "accountRef": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "configName": "pluggy-main",
  "expiresAt": "2026-08-23T12:30:00Z",
  "reconsent": false,
  "token": "eyJhbGciOi...",
  "vendor": "pluggy"
}

Autorizaciones

Authorization · string · header · requerido

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

Parámetros de ruta

id · string · requerido

Opaque aggregator connection id

Respuesta

201

application/json

Created

accountRef · string · requerido

Vendor item/link id this token was scoped to (the stored binding); empty on a first consent. Pass it to the vendor widget's update mode alongside the token — do not substitute a locally cached value.

Ejemplo:

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

configName · string · requerido

Config name of the connection the token was minted for

Ejemplo:

"pluggy-main"

expiresAt · string<date-time> · requerido

UTC instant after which the vendor rejects this consent token

Ejemplo:

"2026-08-23T12:30:00Z"

reconsent · boolean · requerido

Whether the token re-authorizes the connection's existing vendor item/link (true) or will create a new one (false)

Ejemplo:

false

token · string · requerido

Consent token for the vendor widget. Pass it to the widget.

Ejemplo:

"eyJhbGciOi..."

vendor · enum<string> · requerido

Aggregator vendor the consent token was minted against

Opciones disponibles: pluggy, belvo

Ejemplo:

"pluggy"