---
title: "Map a person's main account to a savings account"
method: POST
path: "/v1/persons/{person_id}/deposit_accounts/{account_id}/mappings"
tags: ["Savings Accounts"]
---

# Map a person's main account to a savings account

`POST /v1/persons/{person_id}/deposit_accounts/{account_id}/mappings`

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

## Path parameters

- `person_id` string, required
- `account_id` string, required

## Request body

- CreateDepositAccountsMappingsRequest
  - `main_account_id` string, required — ID of the main account.
  - `deposit_type` 'SAVINGS_ACCOUNT', required — The account type.
  - `reference` string, uuid, required — UUID to use as an idempotency reference for the transaction.

## Response `202`

The mapping was successfully created, and the savings account onboarding process has started.

- CreateDepositAccountsMappingsResponse
  - `id` string, required — ID of the mapping between the main account and the savings account.
  - `main_account_id` string, required — ID of the main account.
  - `status` 'OPENED' | 'TAX_REGISTERED' | 'ACTIVE' | 'INACTIVE' | 'FAILED' — The current status of the savings account.
  - `deposit_type` 'SAVINGS_ACCOUNT', required — The account type.
  - `reference` string, uuid, required — UUID to use as an idempotency reference for the transaction.

## Other responses

- `400` — An error occurred on the client side.
- `403` — You are not authorized to perform this action.
- `404` — The provided 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)