accounts

Create an Account

Creates a TaxCloud account and its first contact. Requires a service credential with the create:accounts scope. The new account's identifier is returned in the response.

Contact

Every account starts with one contact. By default it uses the account email; supply the optional contact object to name a different person. The contact's status is invited until they accept the terms of service, then active.

Note: Creation is not idempotent and has no replay protection. The contact email must be unique across all TaxCloud contacts, so a repeated call with the same email returns 409 rather than a second account; a repeated call with a different email creates a second account. Do not retry this call automatically.

post/mgmt/accounts

Request

  • Base URL: https://api.v3.taxcloud.com
  • URL: https://api.v3.taxcloud.com/mgmt/accounts
  • Auth: HTTP bearer

Request body

$schemastring uri

A URL to the JSON Schema for this object.

einstring

Optional Employer Identification Number. Maximum 12 characters.

emailstring email required

Primary email for the account. Must be a bare address with no display name. On create, also used for the account's first contact unless a contact object overrides it.

namestring required

Legal or trading name of the account. Maximum 50 characters.

phonestring

Optional account phone number. Maximum 16 characters.

stateIncorporatedstring

Optional two-letter state code where the business is incorporated.

Response

Created

$schemastring uri

A URL to the JSON Schema for this object.

accountIdinteger required

Identifier of the account.

createdAtstring date-time required

When the account was created. Stored to the minute.

einstring

Employer Identification Number, when one was supplied.

emailstring required

Primary email for the account.

namestring required

Name of the account.

phonestring

Account phone number, when one was supplied.

stateIncorporatedstring

State of incorporation, when one was supplied.

Changes

No recorded changes to this operation across all 1 revision of this API.