UpsertContactRequest

Request body for upserting a contact by external reference. Supports both creating new contacts and updating existing ones.

connections
Type: array object[] | null · Connection[]

List of company connections (employments).
A link between a contact and a company, used when creating or updating contacts.
- company
  required
  
  Reference to an existing company by ID
  
  kind
  Discriminator
  enum
  const:
  existing
  values
  existing
  id
  Type: string
  required
  
  ID of the existing company
- jobTitle
  Type: null | string
  
  Contact's job title at this company
- primary
  Type: boolean
  
  Whether this is the primary company connection. Exactly one connection must be marked as primary.
email
Type: null | string
max length:
254

Primary email address. Also sets the first entry in emails array if not provided.
emails
Type: array object[] | null · EmailEntryRequest[]

Email addresses with type classification. The first email becomes the primary email if email field is not set.
Email entry in upsert request.
- address
  Type: string
  max length:
  254
  required
  
  Email address.
- type
  Type: null | string
  max length:
  20
  
  Type classification: "work", "personal", or "other".
firstName
Type: null | string
max length:
100

First name.
lastName
Type: null | string
max length:
100

Last name.
phone
Type: null | string
max length:
20

Primary phone number. Also sets the first entry in phones array if not provided.
phones
Type: array object[] | null · PhoneEntryRequest[]

Phone numbers with type classification. The first phone becomes the primary phone if phone field is not set.
Phone entry in upsert request.
- number
  Type: string
  max length:
  30
  required
  
  Phone number (will be normalized to E.164 format).
- type
  Type: null | string
  max length:
  20
  
  Type classification: "mobile", "work", "home", or "other".
primaryLanguage
Type: null | string
max length:
10

ISO 639-1 language code (e.g. "en", "sv").
strategy
Type: null | string
max length:
4000

Investment strategy or description.
tags
Type: array string[] | null

List of tags or labels.