Accounts

Create account

Create a new workspace account owned by the authenticated user.

Copy as Markdown Open in ChatGPT Open in Claude

post/v1/accounts

Request body

namestring required

notification_sender_type'User' | 'Account'

Who signers see as the notification sender for documents in this account. User (default) shows the document owner's name; Account shows this account's name.

Example request

{
  "name": "Acme Inc.",
  "notification_sender_type": "Account"
}

Response

The created account

statusinteger

HTTP status code, mirrored in the body.

messagestring

Human-readable message; empty on success.

Example response

{
  "status": 200,
  "data": {
    "resource": "account",
    "id": "6401df46d6a6b0c692d9ec49",
    "name": "Acme Inc.",
    "primary_color": "aabbcc",
    "secondary_color": "112233",
    "notification_sender_type": "User",
    "roles": [
      "owner"
    ],
    "is_delete_allowed": true,
    "created_at": "2026-06-03T03:54:16Z"
  }
}

Changes

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