v1

latestOpenAPI 3.1.02026-07-263788129.7 KB

Accounts

Update an Account

Updates an existing account by its account_id. Any tags list provided replaces the existing tags on the account.

patch/v1/accounts/{account_id}

Path parameters

account_idstring uuid required

Request body

namestring nullable

Display name for the account

statusstring nullable

Account status

notesstring nullable

Notes about the account

ownerstring uuid nullable

User ID to assign as account owner

tagsstring[] nullable

List of tag IDs to associate with the account

Example request

{
  "name": "Acme Corp",
  "status": "PROSPECTING"
}

Response

Successful Response

Example response

{
  "data": {
    "id": "acc_abc123",
    "name": "Acme Corp",
    "status": "active",
    "owner": {
      "id": "usr_abc123",
      "first_name": "Jane",
      "last_name": "Smith"
    },
    "notes": "Key enterprise prospect",
    "company": {
      "domain": "acme.com",
      "linkedin_url": "https://linkedin.com/company/acme",
      "description": "Enterprise software company specializing in AI-driven sales tools",
      "employee_count": 250,
      "founded_year": 2019,
      "industries": [
        "Software",
        "Artificial Intelligence"
      ],
      "total_funding_usd": 50000000,
      "last_funding_date": "2024-03-15"
    },
    "scoring": {
      "tier": "A",
      "heat_score": "Hot"
    },
    "tags": [
      "Enterprise",
      "High Priority"
    ],
    "created_at": "2025-06-15T10:30:00Z",
    "updated_at": "2025-06-15T10:30:00Z"
  }
}