Sign in

v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Accounts

Update account owner

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

Changes the owner of an account. The new owner must be a member of the caller's team — an ownerUserId outside the team returns 400 contactAccount.invalidInput (404 is reserved for "account row missing").

put/v3/contact-accounts/{id}/owner

Path parameters

idinteger required

Account ID

Request body

userIdinteger required

ID of the new owner user

Response

Account owner 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"
}