Skip to main content
POST /v1/accounts

{
  "id": "c64ce66b70b21c03bfd5dfa0ab14b730",
  "name": "Ted Annature",
  "email": "[email protected]",
  "number": "1300 000 000",
  "timezone": "+10:00",
  "role": "administrator",
  "active": true,
  "organisation_id": "62e9a87c6ed1444d9d228c4a0374017d",
  "group_id": "a5a885caee6286a54ad7bbd4ab5400e9",
  "created": "2019-12-17T05:30:00Z",
  "verified": "2019-12-17T05:30:00Z"
}
Creates a new account that can be used to log in to the Annature dashboard and send, sign, or manage envelopes. By default, newly created accounts will receive a verification email from Annature prompting them to set a password. Until verified, accounts cannot log in or send envelopes. Optionally, a password can be provided in the request to set it programmatically. This is useful when provisioning internal users or simplifying onboarding. If no password is provided, the user will need to set it manually via the verification email. Verification emails can be resent using the Resend verification endpoint.

​
Partner-specific behavior

If you’re part of the Partner Program and supply the X-Annature-Partner header, you may include a skip_verification flag in the request to bypass the standard email verification process. This allows accounts to be created in a pre-verified state — for example, when programmatically provisioning known users or performing a controlled migration.

​
Parameters

​
name
string
required
The full name of the account holder.
​
email
string
required
The email address associated with the account. This will be used to log in to the Annature dashboard.Email addresses must be unique. An error will be returned if the supplied email already exists for another account.
​
password
string
Set the password for the account at the time of creation. If omitted, the user will be asked to set their password via the email verification link.
​
number
string
The account holder’s contact number.
​
timezone
string
The timezone assigned to this account, supplied as a 6-digit UTC offset.Timezones must be supplied as a 6-digit UTC offset. For example:
  • +10:00 → Australia/Brisbane
  • +08:00 → Australia/Perth
​
role
string
The account role. If not specified, the account will default to standard.Possible values: administrator, standard, read-only.
​
group_id
string
The unique identifier of the group this account should be assigned to.
​
skip_verification
boolean
Partner-only: Set this to true to mark the account as verified without sending an email. Requires the X-Annature-Partner header.
POST /v1/accounts

{
  "id": "c64ce66b70b21c03bfd5dfa0ab14b730",
  "name": "Ted Annature",
  "email": "[email protected]",
  "number": "1300 000 000",
  "timezone": "+10:00",
  "role": "administrator",
  "active": true,
  "organisation_id": "62e9a87c6ed1444d9d228c4a0374017d",
  "group_id": "a5a885caee6286a54ad7bbd4ab5400e9",
  "created": "2019-12-17T05:30:00Z",
  "verified": "2019-12-17T05:30:00Z"
}