PersonResponseRaw: {
    current_organization_ids?: number[];
} & Persons.Person & InteractionDateResponseRaw & OpportunityIdResponseRaw

Each person resource is assigned a unique id and stores the name, type, and email addresses of the person. A person resource also has access to a smart attribute called primary_email. The value of primary_email is automatically computed by Affinity's proprietary algorithms and refers to the email that is most likely to be the current active email address of a person. The person resource organization_ids is a collection of unique identifiers to the person's associated organizations. Note that a person can be associated with multiple organizations. For example, say your team has talked with organizations A and B. Person X used to work at A and was your point of contact, but then changed jobs and started emailing you from a new email address (corresponding to organization B). In this case, Affinity will automatically associate person X with both organization A and organization B. The person resource type indicates whether a person is internal or external to your team. Every internal person is a user of Affinity on your team, and all other people are externals. Dates of the most recent and upcoming interactions with a person are available in the interaction_dates field. This data is only included when passing {@link InteractionDatesQueryParams.with_interaction_dates}=true as a query parameter to the /persons or the /persons/{person_id} endpoints.

Type declaration

  • Optionalcurrent_organization_ids?: number[]

    An array of unique identifiers of organizations that the person is currently associated with according to the Affinity Data: Current Organization in-app column. Only returned when {@link WithCurrentOrganizatonParams.with_current_organizations}=true.

    TODO(@joscha): model this in the type system, so the return type is based on the query parameter type.