---
title: "Create a reference account for a business"
method: POST
path: "/v1/businesses/{business_id}/accounts/{account_id}/reference_accounts"
tags: ["Reference accounts"]
---

# Create a reference account for a business

`POST /v1/businesses/{business_id}/accounts/{account_id}/reference_accounts`

Adds an external bank account as a reference account to the business' Solaris account specified in the request URL.<br> **Note:** Before calling this endpoint, you must create a SEPA Direct Debit mandate and have the customer sign it.

## Path parameters

- `business_id` string, required
- `account_id` string, required

## Request body

- object
  - `name` string — The name of the external account holder.
  - `iban` string — IBAN of the reference account.
  - `mandate_number` string — The identifier of the SDD mandate that the customer signed.
  - `mandate_signature_date` string, date — The date when the customer signed the SDD mandate.
  - `mandate_type` 'B2B' | 'Core' — The type of SDD mandate.

## Response `201`

The operation was successful.

- BusinessReferenceAccount
  - `id` string — Unique ID of the reference account.
  - `status` string — Current status of the reference account.
  - `name` string — The reference account holder's name.
  - `iban` string — The reference account's IBAN.
  - `mandate_number` string — The number of the SDD mandate associated with the reference account.
  - `mandate_signature_date` string, date — The date when the customer signed the SDD mandate.
  - `mandate_type` 'B2B' | 'Core' — The type of SDD mandate.

## Other responses

- `400` — Invalid request.
- `403` — You are not authorized to perform this action.
- `404` — The requested resource could not be found.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/account-management.md) · [All operations](https://skmtc.net/solarisgroup/apis/account-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/account-management/revisions/099ef636a5a1/schema)