---
title: "Add account"
method: POST
path: "/credentials/{credentialId}/accounts"
tags: ["Accounts"]
---

# Add account

`POST /credentials/{credentialId}/accounts`

## Request

- Base URL: `//basrvqaap6001.morningstar.com/WPDemo/webportfolio/api/v1` (relative, and the document’s source URL is not known)
- URL: `//basrvqaap6001.morningstar.com/WPDemo/webportfolio/api/v1/credentials/{credentialId}/accounts`
- Auth: API key in header `Authorization`

Add an account to an existing credential.

## Path parameters

- `credentialId` integer, required

## Request body

- AccountPost
  - `accountNumber` string: The account number. This field is required for successful account aggregation, but is not required overall. Accounts without an account number will be considered 'not complete'.
  - `accountNumber2` string: The second account number. It is not required for aggregation at most financial institutions.

## Response `200`

Ok

- DataRecord
  - `data` object

## Other responses

- `400`: Bad Request
- `401`: Not Authorized
- `403`: Forbidden
- `500`: Internal Server Error

## Changes

- **2026-11-03** `475f167d1874`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morningstar/apis/byallaccounts-api-07302024/changes/credentials/:credentialId/accounts/post.md)

---

[API](https://skmtc.dev/morningstar/apis/byallaccounts-api-07302024.md) - [All operations](https://skmtc.dev/morningstar/apis/byallaccounts-api-07302024/llms.txt) - [OpenAPI document](https://skmtc.dev/morningstar/apis/byallaccounts-api-07302024/revisions/475f167d1874?raw)
