---
title: "Add Credential"
method: POST
path: "/credentials"
tags: ["Credentials"]
---

# Add Credential

`POST /credentials`

## 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`
- Auth: API key in header `Authorization`

Add a new account credential to the system

## Request body

- CredentialPost: Credentials provided to BAA for authentication to a third party Financial Institution. The credential may be linked to an established 3rd party Financial Institution by providing the appropriate fiId, or the fiRequestName and fiRequestURL fields may be provided to request support for a new Financial Institution.
  - `name` string, required: Name of the Account Credential
  - `fiId` integer: ID of the Financial Institution. Either the fiId field or the fiRequestName field was must be provided (and not both).
  - `firequestName` string: The name of the requested FI. Either the fiId field or the fiRequestName field was must be provided (and not both)
  - `firequestURL` string: The URL of the requested FI. May only be provided when the fiRequestName is provided (and the fiId field is not provided).
  - `accountLogin` string: Account Login
  - `accountLogin2` string: Account Login 2
  - `accountPin` string: Account Pin
  - `accountSecondPin` string: Account Second Pin
  - `accountNumber` string: Account Number
  - `accountNumber2` string: Account Number 2

## 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/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)
