Skip to main content
POST
/
user?k=
{api_key}
&c=
{client_guid}
{
  "external_user_guid": "GUID-1234",
  "email": "richard@email.com",
  "first_name": "Richard",
  "last_name": "Montague",
  "phone": "8015551234",
  "zip_code": "12345",
  "sex": "MALE"
}

{
  "guid": "USR-00dfffb5-62f6-9865-91f4-9d90f",
  "external_guid": "GUID-1234",
  "external_user_guid": "GUID-1234",
  "client_guid": "CLT-0858efd1-2d2e-6a5d-f2b5-c7dad42ef184",
  "email": "richard@email.com",
  "login_token": "cQQ380Ocyc049z6eRg--tz6Opshfxqz0T6rX2xaD2dwei5H...",
  "first_name": "Richard",
  "last_name": "Montague",
  "phone": "8015551234",
  "birthday": null,
  "sex": 0,
  "credit_score": null,
  "zip_code": 12345,
  "master_widget_url": "https://widgets.moneydesktop.com/raja/master?...",
  "accounts_widget_url": "https://widgets.moneydesktop.com/raja/accounts?...",
  "budgets_widget_url": "https://widgets.moneydesktop.com/raja/budgets?...",
  "debts_widget_url": "https://widgets.moneydesktop.com/raja/debts?...",
  "net_worth_widget_url": "https://widgets.moneydesktop.com/raja/net_worth?...",
  "spending_widget_url": "https://widgets.moneydesktop.com/raja/spending?...",
  "transactions_widget_url": "https://widgets.moneydesktop.com/raja/transactions?...",
  "status": {
    "status": 1,
    "name": "ENABLED",
    "message": ""
  }
}
This endpoint creates a new user.
external_user_guid was not previously required in User create and the request will execute without it for backward compatibility, but it is required in all new implementations. The external_user_guid cannot begin with USR- as this is reserved for the system.
Included in the response is the system-defined master_widget_url, guid, and login_token values.

​
Query Parameters

​
k
string
required
Your API key.
​
c
string
required
The client GUID or external client GUID.

​
Body Parameters

​
external_user_guid
string
required
A unique identifier for the user within the client. Cannot begin with USR-.
​
email
string
The user’s email address.
​
first_name
string
The user’s first name.
​
last_name
string
The user’s last name.
​
phone
string
The user’s phone number.
​
zip_code
string
US Zip code in nnnnn or nnnnn-nnnn format, or a Canadian Postal Code in ana nan format.
​
sex
string
The user’s sex. Accepted values: MALE or FEMALE.
​
birthdate
string
The user’s date of birth in ISO 8601 format (e.g., 1992-03-28).
{
  "external_user_guid": "GUID-1234",
  "email": "richard@email.com",
  "first_name": "Richard",
  "last_name": "Montague",
  "phone": "8015551234",
  "zip_code": "12345",
  "sex": "MALE"
}

{
  "guid": "USR-00dfffb5-62f6-9865-91f4-9d90f",
  "external_guid": "GUID-1234",
  "external_user_guid": "GUID-1234",
  "client_guid": "CLT-0858efd1-2d2e-6a5d-f2b5-c7dad42ef184",
  "email": "richard@email.com",
  "login_token": "cQQ380Ocyc049z6eRg--tz6Opshfxqz0T6rX2xaD2dwei5H...",
  "first_name": "Richard",
  "last_name": "Montague",
  "phone": "8015551234",
  "birthday": null,
  "sex": 0,
  "credit_score": null,
  "zip_code": 12345,
  "master_widget_url": "https://widgets.moneydesktop.com/raja/master?...",
  "accounts_widget_url": "https://widgets.moneydesktop.com/raja/accounts?...",
  "budgets_widget_url": "https://widgets.moneydesktop.com/raja/budgets?...",
  "debts_widget_url": "https://widgets.moneydesktop.com/raja/debts?...",
  "net_worth_widget_url": "https://widgets.moneydesktop.com/raja/net_worth?...",
  "spending_widget_url": "https://widgets.moneydesktop.com/raja/spending?...",
  "transactions_widget_url": "https://widgets.moneydesktop.com/raja/transactions?...",
  "status": {
    "status": 1,
    "name": "ENABLED",
    "message": ""
  }
}