# Map a business' main account to a savings account

Maps a business' savings account to its main (checking) account and then
triggers the remaining steps for savings account onboarding. The business
may only transfer money to and from their savings account using the main
account mapped by this request.


Endpoint: POST /v1/businesses/{business_id}/deposit_accounts/{account_id}/mappings
Version: 1.0

## Path parameters:

  - `business_id` (string, required)
    Unique ID of a business.
    Example: "990bbac68a34add190786b9c74f4c82fcbiz"

  - `account_id` (string, required)
    Unique ID of a Solaris account.
    Example: "e48c29b85992b8772eb7ddd518490920cacc"

## Request fields (application/json):

  - `main_account_id` (string, required)
    ID of the main account.
    Example: "148c29b85992b8772eb7ddd518490110cacc"

  - `deposit_type` (string, required)
    The account type.
    Enum: "SAVINGS_ACCOUNT"

  - `reference` (string, required)
    UUID to use as an idempotency reference for the transaction.
    Example: "162ddd7e-790c-5963-908f-4cedfd30f9a1"

## Response 202 fields (application/json):

  - `id` (string, required)
    ID of the mapping between the main account and the savings account.
    Example: "d222a0b8-07ea-49be-83c1-68719be286e8"

  - `main_account_id` (string, required)
    ID of the main account.
    Example: "148c29b85992b8772eb7ddd518490110cacc"

  - `deposit_type` (string, required)
    The account type.
    Enum: "SAVINGS_ACCOUNT"

  - `reference` (string, required)
    UUID to use as an idempotency reference for the transaction.
    Example: "162ddd7e-790c-5963-908f-4cedfd30f9a1"

  - `status` (string)
    The current status of the savings account.
    Enum: "OPENED", "TAX_REGISTERED", "ACTIVE", "INACTIVE", "FAILED"

## Response 400 fields (application/json):

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

  - `status` (string)
    Example: "400"

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

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

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

## Response 403 fields (application/json):

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

  - `status` (string)
    Example: "403"

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

  - `title` (string)
    Example: "Unauthorized Action"

  - `details` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

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

  - `status` (string)
    Example: "404"

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

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

  - `details` (string)
    Example: "Couldn't find {resource} for id {resource_id}."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

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

  - `title` (string)
    Example: "Generic Error"

  - `details` (string)
    Example: "There was an error."