# Create a reference account for a business

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

Endpoint: POST /v1/businesses/{business_id}/accounts/{account_id}/reference_accounts
Version: 1.0

## Path parameters:

  - `business_id` (string, required)

  - `account_id` (string, required)

## Request fields (application/json):

  - `name` (string)
    The name of the external account holder.
    Example: "account_holder_unique_ref"

  - `iban` (string)
    IBAN of the reference account.
    Example: "DE32110101001000000029"

  - `mandate_number` (string)
    The identifier of the SDD mandate that the customer signed.
    Example: "example-mandate-number"

  - `mandate_signature_date` (string)
    The date when the customer signed the SDD mandate.
    Example: "2020-01-08"

  - `mandate_type` (string)
    The type of SDD mandate.
    Enum: "B2B", "Core"

## Response 201 fields (application/json):

  - `id` (string)
    Unique ID of the reference account.
    Example: "ee4cc80bee604de09d036d8b7a9b6cb0"

  - `status` (string)
    Current status of the reference account.
    Example: "ACTIVE"

  - `name` (string)
    The reference account holder's name.
    Example: "Max Mustermann"

  - `iban` (string)
    The reference account's IBAN.
    Example: "DE32110101001000000029"

  - `mandate_number` (string)
    The number of the SDD mandate associated with the reference account.
    Example: "example-mandate-number"

  - `mandate_signature_date` (string)
    The date when the customer signed the SDD mandate.
    Example: "2020-01-08"

  - `mandate_type` (string)
    The type of SDD mandate.
    Enum: "B2B", "Core"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `code` (string)
    Example: "invalid_request"

  - `title` (string)
    Example: "Invalid Request"

  - `details` (string)
    Example: "Request is invalid"

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "failed to build pagination headers"

  - `details` (string)
    Example: "cannot connect to database"

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `details` (string)
    Example: "Model was not found"

## Response 500 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Internal Server Error"

  - `details` (string)
    Example: "Internal server error. occurred"