Connect Account
POST /accounts
Registers a bank account by IBAN for the Magni client bound to your OAuth client and starts the bank consent. The account exists immediately but holds no data until its owner completes strong customer authentication at the returned URL. IBAN accounts at SIBS-adherent banks only.
Request
POST /api/v1/accounts
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json
| Field | Required | Description |
|---|---|---|
bankCode | required | The bank's SIBS code (ASPSP) |
iban | required | The account IBAN; the bank is cross-checked against it |
friendlyName | optional | A label shown in the OpenBanking portal |
Response — 201 Created
| Field | Description |
|---|---|
accountId | The account id used by DELETE /accounts/{id} and GET /transactions?accountId= |
consentId | The bank consent created for the account |
consentStatus | The consent's current status |
scaRedirectUrl | Where the account owner completes SCA at their bank; send them there |
psuMessage | Text from the bank for the account owner, when provided |
Errors
400 ValidationError / InvalidIban, 401, 403 InsufficientScope / MissingClientBinding, 429, 502 UpstreamError — shape in Error handling.
Availability
Released; callable once your OAuth client is provisioned and bound to a Magni client.