Create a user

Create a commercial user

POST https://sandbox-api.com/v1/users

Returns the user object if successful. Returns an error if create parameters are invalid (e.g. specifying an invalid phone number or incorporation date). The EIN is not included in the response.

Request Body

Name	Type	Description
address*	object	The business's address. Must be a valid US address. For the address schema, see The user object.
first_name*	string	The legal business name
email*	string	The business's email address.
entity*	enum	The type of business. Acceptable values: 'SOLE_PROPRIETORSHIP', 'GENERAL_PARTNERSHIP', 'LIMITED_PARTNERSHIP', 'CORPORATION', 'LIMITED_LIABILITY_COMPANY', 'LIMITED_LIABILITY_PARTNERSHIP'
asset_report_json_gzip	string	The user's Plaid asset report, gzipped with base64 encoding.
EIN*	string	The business's employer identification number (EIN). The EIN must be AES encrypted In CBC Mode using your secret_key (see Creating and Managing Users for more detail)
phone*	string	The business's 10-digit phone number. Must be a valid US phone number.
user_type*	enum	Required to be set to business for commercial users
key_people*	array	A list of owners, directors or other beneficiaries of the business. See the key person object for the schema

200: OK User successfully created

{
    "uuid": "50d6c5df-abd6-43de-9c48-d85146e96c11",
    "first_name": "Fairlender Inc",
    "middle_name": null,
    "last_name": null,
    "dwolla_customer_url": null,
    "user_type": "BUSINESS",
    "start_date": "2012-07-04",
    "website": null,
    "entity": "CORPORATION",
    "industry": null,
    "email": "[e-mail]",
    "phone": "8478887676",
    "address": {
        "line_1": "77 Geary Street",
        "line_2": null,
        "line_3": null,
        "zip": "94108",
        "city": "San Francisco",
        "state": "CA",
        "country": "UNITED STATES"
    },
    "key_people": [
        {
            "uuid": "3189f45f-bdb1-4115-ab41-dde4d6207edb",
            "first_name": "Blair",
            "last_name": "Cassidy",
            "middle_name": "Dufresne",
            "title": "BENEFICIARY",
            "phone": "6166723456",
            "email": "[e-mail]",
            "citizenship": "US",
            "address": {
                "line_1": "161 Stansfield Dr",
                "city": "Zionsville",
                "state": "PA",
                "zip": "18092",
                "country": "UNITED STATES"
            }
        }
    ]
}

401: Unauthorized

{
    // Response
}

403: Forbidden

{
    // Response
}