Skip to main content

Object APIs: Enriched Contacts Schema

The Enriched Contacts API returns data in the following schema:

Field

Format

Description

first_name

String

First name of the contact

last_name

String

Last name of the contact

email

String

(Business) email address for the contact

phone

String

Phone number for the contact

job_title

String

Job title of the contact

department

String

Backstory-classified department for the contact’s job title

seniority

String

Backstory-classified seniority for the contact’s job title

country

String

People-ai-derived country for the contact

state

String

People-ai-derived state for the contact (U.S. states only)

account_name

String

Name for the contact’s account

account_type

String

Account type for the contact’s account

account_domain

String

Domain for the contact’s account (e.g., “backstory”)

account_crm_id

String

Unique CRM identifier for the contact’s account

source_peopleai_id

String

Unique Backstory identifier for the originating user

response_activity_id

String

Unique identifier for the contact’s first response taken from the source system

source_email

String

Email address for the originating user

from_cc

Boolean

Boolean indicating whether or not the contact was created from a CC

total_inbound

Integer

The total number of inbound emails from the contact

total_inbound_30d

Integer

The total number of inbound emails from the contact in the last 30 days

total_outbound

Integer

The total number of outbound emails to the contact

total_outbound_30d

Integer

The total number of outbound emails to the contact in the last 30 days

total_meetings

Integer

The total number of meetings in which the contact was included

total_meetings_30d

Integer

The total number of meetings in which the contact was included in the last 30 days

total_time_spent

Integer

The time spent on all activities involving the contact in seconds

total_time_spent_30d

Integer

The time spent on all activities involving the contact in seconds in the last 30 days

first_inbound_time

yyyy-MM-ddTHH:mm:ssZ (UTC)

The time of the contact’s first inbound activity

last_inbound_time

yyyy-MM-ddTHH:mm:ssZ (UTC)

The time of the contact’s last inbound activity

first_outbound_time

yyyy-MM-ddTHH:mm:ssZ (UTC)

The time of the first outbound activity to the contact

last_outbound_time

yyyy-MM-ddTHH:mm:ssZ (UTC)

The time of the last outbound activity to the contact

last_engaged_time

yyyy-MM-ddTHH:mm:ssZ (UTC)

The time that the contact was last engaged

first_upcoming_meeting_time

yyyy-MM-ddTHH:mm:ssZ (UTC)

The time of the next upcoming meeting with the contact

first_engaged_time

yyyy-MM-ddTHH:mm:ssZ (UTC)

The time the contact was
first engaged

engagement_level

Integer

A numerical representation of sales engagement that is based on activities captured by Backstory.

inbound_outbound_ratio

Float

Ratio between inbound and outbound emails (inbound/outbound)

received_reply

Boolean

Boolean indicating

upcoming_meeting

Boolean

Boolean indicating

total_emails

Integer

Total number of inbound and outbound emails

total_emails_30d

Integer

Total number of inbound and outbound emails in the last 30 days

is_sourced_by_people_ai

Boolean

Indicator of contacts and contact candidates sourced by Backstory

crm_id

String

The CRM ID of the existing contact or lead that was enriched by Backstory

Need help? Drop us a line at support@backstory.ai.

Did this answer your question?