Contact

A contact in your network.

  • createdUtc
    Type: stringFormat: date-time
    required

    Creation timestamp (UTC).

  • etag
    Type: string
    required

    ETag for concurrency control.

  • id
    Type: string
    required

    Contact ID.

  • updatedUtc
    Type: stringFormat: date-time
    required

    Last update timestamp (UTC).

  • changeOrigin
    Type: null | string

    Origin channel that triggered this change. Informational only; treat as an opaque value.

  • changeType
    Type: null | string

    Type of change that produced this version: "create", "update", or "delete"

  • companies
    Type: array object[] · CompanyLink[]

    Companies linked to this contact, primary first.

    Lightweight company reference embedded on a contact, showing the relationship.

    • id
      Type: string
      required

      Company ID.

    • name
      Type: string
      required

      Company name.

    • isPrimary
      Type: boolean

      Whether this is the contact's primary company.

    • jobTitle
      Type: null | string

      Job title at this company.

    • uri
      Type: null | string

      Opaque canonical Propstreet entity URI for deep linking.

  • deletedUtc
    Type: null | stringFormat: date-time

    Deletion timestamp (UTC) if soft-deleted.

  • email
    Type: null | string

    Email address.

  • emails
    Type: array object[] · EmailEntry[]

    All email addresses with type classification. The primary email (from the email field) is included with isPrimary=true.

    An email address entry for a contact.

    • address
      Type: string
      required

      Email address.

    • isPrimary
      Type: boolean

      Whether this is the primary email address for the contact. Computed by comparing with the contact's Email property.

    • type
      Type: null | string

      Type classification: "work", "personal", or "other".

  • externalRefs
    Type: array object[] · ExternalRef[]

    External references.

    Represents an external system reference (e.g., Salesforce, HubSpot, Pipedrive). Supports multiple CRM systems simultaneously.

    • id
      Type: string
      max length:  
      255
      required

      External identifier within the namespace (e.g., "003XXXXXXXXXXXX" for Salesforce). Case-sensitive. Format depends on the external system.

    • namespace
      Type: string
      max length:  
      50
      required

      External system namespace (e.g., "salesforce", "hubspot", "pipedrive", "csv-import"). Case-insensitive.

  • firstName
    Type: null | string

    First name.

  • lastName
    Type: null | string

    Last name.

  • linkedInUrl
    Type: null | string

    LinkedIn profile URL in the format https://www.linkedin.com/in/{slug}.

  • phone
    Type: null | string

    Phone number.

  • phones
    Type: array object[] · PhoneEntry[]

    All phone numbers with type classification. The primary phone (from the phone field) is included with isPrimary=true.

    A phone number entry for a contact.

    • number
      Type: string
      required

      Phone number in E.164 format (e.g., "+4712345678").

    • isPrimary
      Type: boolean

      Whether this is the primary phone number for the contact. Computed by comparing with the contact's PhoneNumber property.

    • type
      Type: null | string

      Type classification: "mobile", "work", "home", or "other".

  • primaryCompanyId
    Type: null | string

    ID of the primary company for this contact.

  • primaryLanguage
    Type: null | string

    Primary language code.

  • profilePictureUrl
    Type: null | string

    URL to download the profile picture, if set.

  • strategy
    Type: null | string

    Investment strategy.

  • tags
    Type: array string[]

    List of tags.

  • uri
    Type: null | string

    Opaque canonical Propstreet entity URI for deep linking.