v1

latestOpenAPI 3.1.02026-07-26359254.7 MB

Accounts

Update an account

<small>Requires the contacts:write scope (or a broader one that includes it).</small>

Updates an existing account.

put/v3/contact-accounts/{id}

Path parameters

idinteger required

Account ID

Request body

namestring required

Contact account name

descriptionstring nullable

Optional description

domainNamestring nullable

Primary domain name

domainSecondarystring nullable

Secondary domain name

industrystring nullable

Industry of the company

companySize'Empty' | 'SelfEmployed' | '2-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001+' nullable

Company size range

countrystring nullable

Country of the company

statestring nullable

State or province

citystring nullable

City

timeZoneIdstring nullable

Time zone identifier

linkedInUrlstring nullable

LinkedIn profile URL

phonestring nullable

Phone number

twitterUrlstring nullable

Twitter profile URL

logoUrlstring nullable

Company logo URL

emailstring nullable

Contact email address

ownerUserIdinteger

ID of the user who owns this contact account

Response

Account updated successfully

idinteger

Unique identifier of the contact account

ownerUserIdinteger

ID of the user who owns this contact account

namestring

Contact account name

descriptionstring nullable

Optional description of the contact account

domainNamestring nullable

Primary domain name

domainSecondarystring nullable

Secondary domain name

industrystring nullable

Industry of the company

companySize'Empty' | 'SelfEmployed' | '2-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001+' nullable

Company size range

countrystring nullable

Country of the company

statestring nullable

State or province

citystring nullable

City

timeZoneIdstring nullable

Time zone identifier

linkedInUrlstring nullable

LinkedIn profile URL

phonestring nullable

Phone number

twitterUrlstring nullable

Twitter profile URL

logoUrlstring nullable

Company logo URL

emailstring nullable

Contact email address

emailProvider'other' | 'gSuite' | 'office' | 'zoho' | 'mimecast' | 'proofpoint' | 'yandex' | 'ovh' | 'goDaddy' | 'ionos' | 'gandi' | 'hostinger' | 'oneAndOne' | 'amazon' | 'barracuda' | 'spamexperts' | 'hotmail' | 'liveCom' | 'yahoo' | 'bloomberg' | 'gmail' | 'outlook' | 'ciscoSecureEmail' | 'titanMail' | 'protonmail' | 'namecheap' | 'appleMail' | 'linkedin' nullable

Email hosting provider for the account's primary domain, resolved from the domain's MX records. null when the account has no domain or the provider could not be determined.

linkedProspectsCountinteger

Number of contacts linked to this account

createdDatestring date-time

Date when the account was created

lastActivityDatestring date-time

Date of the last activity on this account

Example response

{
  "id": 12345,
  "ownerUserId": 42,
  "name": "Acme Corporation",
  "description": "Enterprise software company",
  "domainName": "acme.com",
  "domainSecondary": "acme.io",
  "industry": "Software",
  "companySize": "51-200",
  "country": "United States",
  "state": "California",
  "city": "San Francisco",
  "timeZoneId": "America/Los_Angeles",
  "linkedInUrl": "https://www.linkedin.com/company/acme",
  "phone": "+1-415-555-0100",
  "twitterUrl": "https://twitter.com/acme",
  "logoUrl": "https://cdn.example.com/logos/acme.png",
  "email": "info@acme.com",
  "emailProvider": "office",
  "stage": {
    "id": 3,
    "name": "Qualified",
    "colorId": 2
  },
  "linkedProspectsCount": 17,
  "createdDate": "2026-01-15T09:30:00Z",
  "lastActivityDate": "2026-06-20T14:05:00Z"
}