Create Account

Use this endpoint to create an account.

This endpoint accepts the optional MX-SKIP-WEBHOOK header.

POST

/users/{user_id}/members/{member_id}/accounts

Path Parameters

Field	Required	Type
user_id	Required	String
member_id	Required	String

Request Body

Field	Required	Type
account_number	Optional	String
apr	Optional	Decimal
apy	Optional	Decimal
available_balance	Optional	Decimal
available_credit	Optional	Decimal
balance	Required	Decimal
cash_advance_apr	Optional	Decimal
cash_surrender_value	Optional	Decimal
credit_limit	Optional	Decimal
currency_code	Optional	String
day_payment_is_due	Optional	Integer
death_benefit	Optional	String
has_monthly_transfer_limit	Optional	Boolean
id	Required	String
insured_name	Optional	String
interest_rate	Optional	Decimal
is_closed	Optional	Boolean
is_hidden	Optional	Boolean
last_payment	Optional	Decimal
last_payment_at	Optional	Integer
last_payment_on	Optional	String
loan_amount	Optional	Decimal
matures_at	Optional	Integer
matures_on	Optional	String
metadata	Optional	String
minimum_balance	Optional	Decimal
minimum_payment	Optional	Decimal
monthly_transfer_count	Optional	Decimal
name	Required	String
nickname	Optional	String
original_balance	Optional	Decimal
past_due_amount	Optional	Decimal
past_due_at	Optional	Integer
past_due_on	Optional	String
payment_due_at	Optional	Integer
payment_due_on	Optional	String
payoff_balance	Optional	Decimal
pay_out_amount	Optional	Decimal
pending_balance	Optional	Decimal
premium_amount	Optional	Decimal
routing_number	Optional	String
started_at	Optional	Integer
started_on	Optional	String
statement_balance	Optional	Integer
statement_closed_on	Optional	String
subtype	Optional	String
type	Required	String

Request sample

Language:JAVAPYTHONRUBYSHELL

_72

import java.io.BufferedReader;

_72

import java.io.InputStreamReader;

_72

import java.io.OutputStream;

_72

import java.net.URL;

_72

import javax.net.ssl.HttpsURLConnection;

_72

import org.json.JSONObject;

_72

_72

public class MDX_RealTime {

_72

private String BaseUrl, ClientId, ApiKey;

_72

_72

public MDX_RealTime(String BaseUrl, String ClientId, String ApiKey) {

_72

this.BaseUrl = BaseUrl;

_72

this.ClientId = ClientId;

_72

this.ApiKey = ApiKey;

_72

}

_72

_72

public static void main(String[] args) throws Exception {

_72

String base_url = "https://int-live.moneydesktop.com";

_72

String client_id = ":client_id";

_72

String api_key = ":api_key";

_72

_72

MDX_RealTime mdx = new MDX_RealTime(base_url, client_id, api_key);

_72

_72

/// Setup Account Create json object

_72

String user_id = "U-39XBF7";

_72

String member_id = "M-39XBF7";

_72

String account_id = "A-XA5Y4L";

_72

JSONObject account = new JSONObject();

_72

JSONObject fields = new JSONObject();

_72

fields.put("id", account_id);

_72

fields.put("account_number", "XXXXX-678");

_72

fields.put("available_balance", 175.0);

_72

fields.put("balance", 175.0);

_72

fields.put("minimum_balance", 5);

_72

fields.put("name", "Premium Savings");

_72

fields.put("type", "SAVINGS");

_72

account.put("account", fields);

_72

_72

mdx.CreateAccount(user_id, member_id, account);

_72

}

_72

_72

public void CreateAccount(String user_id, String member_id, JSONObject account) {

_72

try {

_72

String uri = BaseUrl + "/" + ClientId + "/users/" + user_id + "/members/" + member_id + "/accounts.json";

_72

URL url = new URL(uri);

_72

_72

HttpsURLConnection con = (HttpsURLConnection) url.openConnection();

_72

con.setRequestMethod("POST");

_72

con.setRequestProperty("Accept", "application/vnd.moneydesktop.mdx.v5+json");

_72

con.setRequestProperty("Content-Type", "application/vnd.moneydesktop.mdx.v5+json");

_72

con.setRequestProperty("MD-API-KEY", ApiKey);

_72

con.setDoOutput(true);

_72

_72

OutputStream out = con.getOutputStream();

_72

out.write(account.toString().getBytes("UTF-8"));

_72

out.close();

_72

_72

BufferedReader in = new BufferedReader(new InputStreamReader(con.getInputStream()));

_72

String inputLine;

_72

StringBuffer response = new StringBuffer();

_72

while ((inputLine = in.readLine()) != null) {

_72

response.append(inputLine);

_72

}

_72

in.close();

_72

con.disconnect();

_72

_72

System.out.println(response.toString());

_72

} catch (Exception e) {

_72

System.out.println(e);

_72

}

_72

}

_72

}

Response sample

200

Language:json

_51

{

_51

"account": {

_51

"account_number": "12345-678",

_51

"apr": null,

_51

"apy": null,

_51

"available_balance": 175,

_51

"available_credit": null,

_51

"balance": 175,

_51

"credit_limit": null,

_51

"currency_code": "USD",

_51

"daily_deposit_limit_current": 46412.94,

_51

"daily_deposit_limit_total": 20000,

_51

"day_payment_is_due": null,

_51

"guid": "ACT-a341b026-635c-8318-002c-9f3a58b0eff8",

_51

"hold_total": 150.5,

_51

"id": "A-XZ5Y4L",

_51

"interest_paid_previous_year": 230.8,

_51

"interest_paid_ytd": 89.56,

_51

"interest_rate": null,

_51

"is_closed": null,

_51

"is_hidden": false,

_51

"last_payment": null,

_51

"last_payment_at": 0,

_51

"last_payment_on": null,

_51

"matures_at": 0,

_51

"matures_on": null,

_51

"member_guid": "MBR-3e4f6897-06ae-e08a-29b2-27d62e574978",

_51

"member_id": "M-39XBF7",

_51

"metadata": null,

_51

"minimum_balance": 5,

_51

"minimum_payment": null,

_51

"monthly_deposit_limit_current": 46412.94,

_51

"monthly_deposit_limit_total": 20000,

_51

"name": "Premium Savings",

_51

"nickname": null,

_51

"original_balance": null,

_51

"payment_due_at": 0,

_51

"payoff_balance": null,

_51

"pending_transactions_total": 51.25,

_51

"principal_balance": 300.89,

_51

"started_at": 0,

_51

"started_on": null,

_51

"statement_balance": null,

_51

"statement_closed_on": null,

_51

"statement_late_charges": 25,

_51

"subtype": null,

_51

"type": "SAVINGS",

_51

"user_guid": "USR-fe9bb059-67c4-0e6b-e8cd-3fa00b2b5735",

_51

"user_id": "U-39XBF7"

_51

}

_51

}