Skip to main content
POST
/
accounts
Create manual accounts
curl --request POST \
  --url https://int-data.moneydesktop.com/accounts \
  --header 'Content-Type: application/vnd.mx.nexus.v1+json' \
  --header 'MD-SESSION-TOKEN: <api-key>' \
  --data '{}'
{
  "account": {
    "account_number": "4921710685",
    "account_number_set_by": 1,
    "account_number_set_by_name": "FEED",
    "account_subtype": null,
    "account_subtype_name": null,
    "account_subtype_set_by": null,
    "account_subtype_set_by_name": null,
    "account_type": 1,
    "account_type_name": "CHECKING",
    "account_type_set_by": 1,
    "account_type_set_by_name": "FEED",
    "apr": null,
    "apr_set_by": null,
    "apr_set_by_name": null,
    "apy": null,
    "apy_set_by": null,
    "apy_set_by_name": null,
    "available_balance": 500000,
    "available_balance_set_by": 1,
    "available_balance_set_by_name": "FEED",
    "available_credit": null,
    "available_credit_set_by": null,
    "available_credit_set_by_name": null,
    "balance": 500000,
    "balance_set_by": 1,
    "balance_set_by_name": "FEED",
    "calculated_apr": null,
    "cash_balance": null,
    "cash_balance_set_by": null,
    "cash_balance_set_by_name": null,
    "cash_surrender_value": null,
    "cash_surrender_value_set_by": null,
    "cash_surrender_value_set_by_name": null,
    "created_at": "2020-09-21T19:43:44+00:00",
    "credit_limit": null,
    "credit_limit_set_by": null,
    "credit_limit_set_by_name": null,
    "currency_code": null,
    "currency_code_set_by": null,
    "currency_code_set_by_name": null,
    "day_payment_is_due": 12,
    "day_payment_is_due_set_by": 1,
    "day_payment_is_due_set_by_name": "FEED",
    "death_benefit": null,
    "death_benefit_set_by": null,
    "death_benefit_set_by_name": null,
    "external_guid": "23445745",
    "feed_account_number": "4921710685",
    "feed_account_subtype": null,
    "feed_account_subtype_name": null,
    "feed_account_type": 1,
    "feed_account_type_name": "CHECKING",
    "feed_apr": null,
    "feed_apy": null,
    "feed_available_balance": 500000,
    "feed_balance": 500000,
    "feed_cash_balance": null,
    "feed_cash_surrender_value": null,
    "feed_credit_limit": null,
    "feed_currency_code": null,
    "feed_day_payment_is_due": 12,
    "feed_death_benefit": null,
    "feed_holdings_value": null,
    "feed_interest_rate": null,
    "feed_is_closed": null,
    "feed_last_payment": null,
    "feed_last_payment_at": null,
    "feed_loan_amount": null,
    "feed_matures_on": null,
    "feed_minimum_balance": null,
    "feed_minimum_payment": null,
    "feed_name": "Checking",
    "feed_nickname": null,
    "feed_original_balance": null,
    "feed_payment_due_at": "2021-05-12T16:01:00+00:00",
    "feed_payoff_balance": null,
    "feed_routing_number": null,
    "feed_started_on": null,
    "feed_statement_balance": null,
    "feed_total_account_value": null,
    "guid": "ACT-8e6f92c8-1491-42ce-8bf6-c309e9531530",
    "holdings_value": null,
    "holdings_value_set_by": null,
    "holdings_value_set_by_name": null,
    "institution_guid": "INS-1572a04c-912b-59bf-5841-332c7dfafaef",
    "insured_name": null,
    "interest_rate": null,
    "interest_rate_set_by": null,
    "interest_rate_set_by_name": null,
    "is_business": false,
    "is_closed": false,
    "is_closed_set_by": 3,
    "is_closed_set_by_name": "SYSTEM",
    "is_hidden": false,
    "is_manual": false,
    "last_payment": null,
    "last_payment_at": null,
    "last_payment_at_set_by": null,
    "last_payment_at_set_by_name": null,
    "last_payment_set_by": null,
    "last_payment_set_by_name": null,
    "loan_amount": null,
    "loan_amount_set_by": null,
    "loan_amount_set_by_name": null,
    "matures_on": null,
    "matures_on_set_by": null,
    "matures_on_set_by_name": null,
    "member_guid": "MBR-84ca0882-ad6c-4f10-817f-c8c0de7424fa",
    "member_is_managed_by_user": true,
    "metadata": null,
    "minimum_balance": null,
    "minimum_balance_set_by": null,
    "minimum_balance_set_by_name": null,
    "minimum_payment": null,
    "minimum_payment_set_by": null,
    "minimum_payment_set_by_name": null,
    "name": "Checking",
    "name_set_by": 1,
    "name_set_by_name": "FEED",
    "nickname": null,
    "nickname_set_by": null,
    "nickname_set_by_name": null,
    "original_balance": null,
    "original_balance_set_by": null,
    "original_balance_set_by_name": null,
    "pay_out_amount": null,
    "payment_due_at": "2021-05-12T16:01:00+00:00",
    "payment_due_at_set_by": 1,
    "payment_due_at_set_by_name": "FEED",
    "payoff_balance": null,
    "payoff_balance_set_by": null,
    "payoff_balance_set_by_name": null,
    "premium_amount": null,
    "property_type": null,
    "property_type_name": null,
    "revision": 648,
    "routing_number": null,
    "started_on": null,
    "started_on_set_by": null,
    "started_on_set_by_name": null,
    "statement_balance": null,
    "statement_balance_set_by": null,
    "statement_balance_set_by_name": null,
    "total_account_value": null,
    "total_account_value_set_by": null,
    "total_account_value_set_by_name": null,
    "updated_at": "2022-06-14T21:17:09+00:00",
    "user_guid": "USR-11141024-90b3-1bce-cac9-c06ced52ab4c"
  }
}
Creating a manual account will automatically create it under the Manual Institution member. Since a manual account has no credentials tied to the member, the account will never aggregate or include data from a data feed. This endpoint accepts the optional MX-Skip-Webhook header and skip_webhook parameter.

Authorizations

MD-SESSION-TOKEN
string
header
required

MX Session Token

  • Request an API token using the read API token endpoint in the MX SSO API.
  • Exchange an API token for a session token.
    • A session token is obtained by sending a POST request to /sessions
    • The session token will be used in each request made for the user. It should be passed in an MD-SESSION-TOKEN HTTP header as shown below.
    • This session token is valid for 30 minutes from the time it was created. The 30 minute expiration counter is refreshed with each call.
    • If you send a request with an expired session token you'll receive an error code of 4011.
curl -i https://int-data.moneydesktop.com/accounts \
-H 'MD-SESSION-TOKEN: CWforZl1Vn2vC_v6H4rnQRT1DoWpDouJAV-_5TBmiQRAtA8rsOG_BoajTiOSsL0A3bd-bmHXlA-eQzc9ywItKg' \
-H 'Content-Type: application/vnd.mx.nexus.v1+json' \
-H 'Accept: application/vnd.mx.nexus.v1+json'

In documentation code examples, replace <API_KEY_VALUE> with the session token.

Headers

MD-SESSION-TOKEN
string
required

Body

application/vnd.mx.nexus.v1+json
account
object

Response

200 - application/vnd.mx.nexus.v1+json

OK

account
object