People

Assert a person Record

Use this endpoint to create or update person records, using a unique attribute to search for existing People (for example the email_addresses attribute). If a person is found with the same value for the matching attribute, that person will be updated. If no person with the same value for the matching attribute is found, a new person will be created instead. If you would like to avoid matching, please use the Create person endpoint.

If the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. For any other multiselect attribute, all values will be either created or deleted as necessary to match the list of supplied values.

Required scopes: record_permission:read-write, object_configuration:read.

PUT

objects

people

records

curl --request PUT \
  --url https://api.attio.com/v2/objects/people/records \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "values": {
      "email_addresses": [
        "john-smith@attio.com"
      ],
      "name": [
        {
          "first_name": "John",
          "last_name": "Smith",
          "full_name": "John Smith"
        }
      ],
      "description": "Developer met at event",
      "company": [
        {
          "target_object": "companies",
          "target_record_id": "99a03ff3-0435-47da-95cc-76b2caeb4dab"
        },
        {
          "target_object": "companies",
          "domains": [
            {
              "domain": "attio.com"
            }
          ]
        }
      ],
      "phone_numbers": [
        {
          "original_phone_number": "+15558675309",
          "country_code": "US"
        }
      ],
      "primary_location": [
        {
          "line_1": "1 Infinite Loop",
          "line_2": null,
          "line_3": null,
          "line_4": null,
          "locality": "Cupertino",
          "region": "CA",
          "postcode": "95014",
          "country_code": "US",
          "latitude": "37.331741",
          "longitude": "-122.030333"
        }
      ],
      "linkedin": "https://linkedin.com/in/johnsmith"
    }
  }
}'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
      "record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b"
    },
    "created_at": "2022-11-21T13:22:49.061281000Z",
    "values": {
      "strongest_connection_strength_legacy": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": 54.725113205693695,
          "attribute_type": "number"
        }
      ],
      "last_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "twitter": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://x.com/johnsmith",
          "attribute_type": "text"
        }
      ],
      "avatar_url": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6",
          "attribute_type": "text"
        }
      ],
      "job_title": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "Software Engineer",
          "attribute_type": "text"
        }
      ],
      "next_calendar_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "company": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "target_object": "companies",
          "target_record_id": "f528bd86-8142-4359-9a8c-b651d50a27b1",
          "attribute_type": "record-reference"
        }
      ],
      "primary_location": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "line_1": "1 Infinite Loop",
          "line_2": null,
          "line_3": null,
          "line_4": null,
          "locality": "Cupertino",
          "region": "CA",
          "postcode": "95014",
          "country_code": "US",
          "latitude": "37.331741",
          "longitude": "-122.030333",
          "attribute_type": "location"
        }
      ],
      "angellist": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://angellist.com/johnsmith",
          "attribute_type": "text"
        }
      ],
      "description": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "value": "Developer met at event",
          "attribute_type": "text"
        }
      ],
      "strongest_connection_user": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "referenced_actor_type": "workspace-member",
          "referenced_actor_id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64",
          "attribute_type": "actor-reference"
        }
      ],
      "strongest_connection_strength": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "option": {
            "id": {
              "workspace_id": "ca10906c-6785-464e-bb6c-b003e63c6a18",
              "object_id": "cf49cf53-dbb4-4d18-87fc-28aba21d7a49",
              "attribute_id": "7914c8c4-34b1-42b6-9e4c-4db8baa58bfa",
              "option_id": "e37175a9-94f3-410f-bb29-78287bc1c444"
            },
            "title": "Very strong",
            "is_archived": false
          },
          "attribute_type": "select"
        }
      ],
      "last_email_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "system",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "email_addresses": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "original_email_address": "john-smith@attio.com",
          "email_address": "john-smith@attio.com",
          "email_domain": "attio.com",
          "email_root_domain": "attio.com",
          "email_local_specifier": "john-smith",
          "attribute_type": "email-address"
        }
      ],
      "first_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "system",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "created_at": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "2023-01-01T15:00:00.000000000Z",
          "attribute_type": "timestamp"
        }
      ],
      "created_by": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "referenced_actor_type": "workspace-member",
          "referenced_actor_id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64",
          "attribute_type": "actor-reference"
        }
      ],
      "last_calendar_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "linkedin": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://linkedin.com/in/johnsmith",
          "attribute_type": "text"
        }
      ],
      "facebook": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://facebook.com/johnsmith",
          "attribute_type": "text"
        }
      ],
      "name": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "first_name": "John",
          "last_name": "Smith",
          "full_name": "John Smith",
          "attribute_type": "personal-name"
        }
      ],
      "first_calendar_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "twitter_follower_count": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": 100,
          "attribute_type": "number"
        }
      ],
      "instagram": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://instagram.com/johnsmith",
          "attribute_type": "text"
        }
      ],
      "first_email_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "phone_numbers": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "country_code": "US",
          "original_phone_number": "+15558675309",
          "phone_number": "+15558675309",
          "attribute_type": "phone-number"
        }
      ]
    }
  }
}

Authorizations

Authorization

string

header

required

This API uses OAuth 2.0 with the authorization code grant flow.

Query Parameters

matching_attribute

string

required

The ID or slug of the attribute to use to check if a person already exists. The attribute must be unique. For person records email_addresses is the only unique attribute, but you can add additional custom attributes with unique constraints.

Example:

"email_addresses"

Body

application/json

data

object

required

data.values

object

required

This object's keys should be the slugs or IDs of the attributes you wish to update. Below, you'll find documentation for the value types of each standard person attribute. For information on potential custom attributes, refer to our attribute type docs.

data.values.email_addresses

object[]

data.values.name

object[]

data.values.description

object[]

data.values.avatar_url

object[]

data.values.job_title

object[]

data.values.phone_numbers

object[]

data.values.linkedin

object[]

data.values.twitter

object[]

data.values.facebook

object[]

data.values.instagram

object[]

data.values.angellist

object[]

data.values.primary_location

object[]

data.values.primary_location.line_1

string | null

required

The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.

Example:

"1 Infinite Loop"

data.values.primary_location.line_2

string | null

required

The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.

Example:

"Block 1"

data.values.primary_location.line_3

string | null

required

The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.

Example:

"Hilldrop Estate"

data.values.primary_location.line_4

string | null

required

The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.

Example:

"Westborough"

data.values.primary_location.locality

string | null

required

The town, neighborhood or area the location is in.

Example:

"Cupertino"

data.values.primary_location.region

string | null

required

The state, county, province or region that the location is in.

Example:

"CA"

data.values.primary_location.postcode

string | null

required

The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}

Example:

"95014"

data.values.primary_location.country_code

enum<string> | null

required

The ISO 3166-1 alpha-2 country code for the country this location is in.

Available options:

AF,

AX,

AL,

DZ,

AS,

AD,

AO,

AI,

AQ,

AG,

AR,

AM,

AW,

AU,

AT,

AZ,

BS,

BH,

BD,

BB,

BY,

BE,

BZ,

BJ,

BM,

BT,

BO,

BA,

BW,

BV,

BR,

IO,

BN,

BG,

BF,

BI,

KH,

CM,

CA,

CV,

KY,

CF,

TD,

CL,

CN,

CX,

CC,

CO,

KM,

CG,

CD,

CK,

CR,

CI,

HR,

CU,

CW,

CY,

CZ,

DK,

DJ,

DM,

DO,

EC,

EG,

SV,

GQ,

ER,

EE,

ET,

FK,

FO,

FJ,

FI,

FR,

GF,

PF,

TF,

GA,

GM,

GE,

DE,

GH,

GI,

GR,

GL,

GD,

GP,

GU,

GT,

GG,

GN,

GW,

GY,

HT,

HM,

VA,

HN,

HK,

HU,

IS,

IN,

ID,

IR,

IQ,

IE,

IM,

IL,

IT,

JM,

JP,

JE,

JO,

KZ,

KE,

KI,

KR,

KW,

KG,

LA,

LV,

LB,

LS,

LR,

LY,

LI,

LT,

LU,

MO,

MK,

MG,

MW,

MY,

MV,

ML,

MT,

MH,

MQ,

MR,

MU,

YT,

MX,

FM,

MD,

MC,

MN,

ME,

MS,

MA,

MZ,

MM,

NA,

NR,

NP,

NL,

AN,

NC,

NZ,

NI,

NE,

NG,

NU,

NF,

MP,

NO,

OM,

PK,

PW,

PS,

PA,

PG,

PY,

PE,

PH,

PN,

PL,

PT,

PR,

QA,

RE,

RO,

RU,

RW,

BL,

SH,

KN,

LC,

MF,

PM,

VC,

WS,

SM,

ST,

SA,

SN,

SS,

RS,

SC,

SL,

SG,

SK,

SI,

SB,

SO,

ZA,

GS,

ES,

LK,

SD,

SR,

SJ,

SZ,

SE,

CH,

SY,

TW,

TJ,

TZ,

TH,

TL,

TG,

TK,

TO,

TT,

TN,

TR,

TM,

TC,

TV,

UG,

UA,

AE,

GB,

US,

UM,

UY,

UZ,

VU,

VE,

VN,

VG,

VI,

WF,

EH,

YE,

ZM,

ZW

Example:

"US"

data.values.primary_location.latitude

string | null

required

The latitude of the location. Validated by the regular expression /^[-+]?([1-8]?\d(\.\d+)?|90(\.0+)?)$/. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}

Example:

"37.331741"

data.values.primary_location.longitude

string | null

required

The longitude of the location. Validated by the regular expression /^[-+]?(180(\.0+)?|((1[0-7]\d)|([1-9]?\d))(\.\d+)?)$/

Example:

"-122.030333"

data.values.twitter_follower_count

object[]

data.values.company

object[]

Example:

{
  "email_addresses": ["john-smith@attio.com"],
  "name": [
    {
      "first_name": "John",
      "last_name": "Smith",
      "full_name": "John Smith"
    }
  ],
  "description": "Developer met at event",
  "company": [
    {
      "target_object": "companies",
      "target_record_id": "99a03ff3-0435-47da-95cc-76b2caeb4dab"
    },
    {
      "target_object": "companies",
      "domains": [{ "domain": "attio.com" }]
    }
  ],
  "phone_numbers": [
    {
      "original_phone_number": "+15558675309",
      "country_code": "US"
    }
  ],
  "primary_location": [
    {
      "line_1": "1 Infinite Loop",
      "line_2": null,
      "line_3": null,
      "line_4": null,
      "locality": "Cupertino",
      "region": "CA",
      "postcode": "95014",
      "country_code": "US",
      "latitude": "37.331741",
      "longitude": "-122.030333"
    }
  ],
  "linkedin": "https://linkedin.com/in/johnsmith"
}

Response

200

application/json

Success

data

object

required

data.id

object

required

data.created_at

string

required

When this record was created.

Example:

"2022-11-21T13:22:49.061281000Z"

data.values

object

required

An object with attribute_slug keys, and an array of value objects as the values. Attributes slugs (for example email_addresses or name) can be used, including custom attribute slugs.

data.values.email_addresses

object[]

data.values.email_addresses.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.email_addresses.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.email_addresses.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.email_addresses.original_email_address

string

required

Example:

"alice@app.attio.com"

data.values.email_addresses.email_address

string

required

Example:

"alice@app.attio.com"

data.values.email_addresses.email_domain

string

required

Example:

"app.attio.com"

data.values.email_addresses.email_root_domain

string

required

Example:

"attio.com"

data.values.email_addresses.email_local_specifier

string

required

Example:

"alice"

data.values.email_addresses.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

email-address

Example:

"email-address"

data.values.name

object[]

data.values.name.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.name.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.name.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.name.first_name

string

required

The first name.

Example:

"Ada"

data.values.name.last_name

string

required

The last name.

Example:

"Lovelace"

data.values.name.full_name

string

required

The full name.

Example:

"Ada Lovelace"

data.values.name.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

personal-name

Example:

"personal-name"

data.values.description

object[]

data.values.description.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.description.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.description.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.description.value

string

required

A raw text field. Values are limited to 10MB.

Example:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

data.values.description.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

data.values.avatar_url

object[]

data.values.avatar_url.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.avatar_url.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.avatar_url.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.avatar_url.value

string

required

A raw text field. Values are limited to 10MB.

Example:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

data.values.avatar_url.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

data.values.job_title

object[]

data.values.job_title.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.job_title.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.job_title.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.job_title.value

string

required

A raw text field. Values are limited to 10MB.

Example:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

data.values.job_title.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

data.values.phone_numbers

object[]

data.values.phone_numbers.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.phone_numbers.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.phone_numbers.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.phone_numbers.original_phone_number

string

required

The raw, original phone number, as inputted.

Example:

"5558675309"

data.values.phone_numbers.country_code

enum<string>

required

The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to.

Available options:

AF,

AX,

AL,

DZ,

AS,

AD,

AO,

AI,

AQ,

AG,

AR,

AM,

AW,

AU,

AT,

AZ,

BS,

BH,

BD,

BB,

BY,

BE,

BZ,

BJ,

BM,

BT,

BO,

BA,

BW,

BV,

BR,

IO,

BN,

BG,

BF,

BI,

KH,

CM,

CA,

CV,

KY,

CF,

TD,

CL,

CN,

CX,

CC,

CO,

KM,

CG,

CD,

CK,

CR,

CI,

HR,

CU,

CW,

CY,

CZ,

DK,

DJ,

DM,

DO,

EC,

EG,

SV,

GQ,

ER,

EE,

ET,

FK,

FO,

FJ,

FI,

FR,

GF,

PF,

TF,

GA,

GM,

GE,

DE,

GH,

GI,

GR,

GL,

GD,

GP,

GU,

GT,

GG,

GN,

GW,

GY,

HT,

HM,

VA,

HN,

HK,

HU,

IS,

IN,

ID,

IR,

IQ,

IE,

IM,

IL,

IT,

JM,

JP,

JE,

JO,

KZ,

KE,

KI,

KR,

KW,

KG,

LA,

LV,

LB,

LS,

LR,

LY,

LI,

LT,

LU,

MO,

MK,

MG,

MW,

MY,

MV,

ML,

MT,

MH,

MQ,

MR,

MU,

YT,

MX,

FM,

MD,

MC,

MN,

ME,

MS,

MA,

MZ,

MM,

NA,

NR,

NP,

NL,

AN,

NC,

NZ,

NI,

NE,

NG,

NU,

NF,

MP,

NO,

OM,

PK,

PW,

PS,

PA,

PG,

PY,

PE,

PH,

PN,

PL,

PT,

PR,

QA,

RE,

RO,

RU,

RW,

BL,

SH,

KN,

LC,

MF,

PM,

VC,

WS,

SM,

ST,

SA,

SN,

SS,

RS,

SC,

SL,

SG,

SK,

SI,

SB,

SO,

ZA,

GS,

ES,

LK,

SD,

SR,

SJ,

SZ,

SE,

CH,

SY,

TW,

TJ,

TZ,

TH,

TL,

TG,

TK,

TO,

TT,

TN,

TR,

TM,

TC,

TV,

UG,

UA,

AE,

GB,

US,

UM,

UY,

UZ,

VU,

VE,

VN,

VG,

VI,

WF,

EH,

YE,

ZM,

ZW

Example:

"US"

data.values.phone_numbers.phone_number

string

required

Example:

"+15558675309"

data.values.phone_numbers.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

phone-number

Example:

"phone-number"

data.values.linkedin

object[]

data.values.linkedin.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.linkedin.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.linkedin.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.linkedin.value

string

required

A raw text field. Values are limited to 10MB.

Example:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

data.values.linkedin.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

data.values.twitter

object[]

data.values.twitter.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.twitter.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.twitter.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.twitter.value

string

required

A raw text field. Values are limited to 10MB.

Example:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

data.values.twitter.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

data.values.facebook

object[]

data.values.facebook.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.facebook.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.facebook.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.facebook.value

string

required

A raw text field. Values are limited to 10MB.

Example:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

data.values.facebook.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

data.values.instagram

object[]

data.values.instagram.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.instagram.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.instagram.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.instagram.value

string

required

A raw text field. Values are limited to 10MB.

Example:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

data.values.instagram.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

data.values.angellist

object[]

data.values.angellist.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.angellist.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.angellist.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.angellist.value

string

required

A raw text field. Values are limited to 10MB.

Example:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

data.values.angellist.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

data.values.primary_location

object[]

data.values.primary_location.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.primary_location.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.primary_location.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.primary_location.line_1

string | null

required

The first line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.

Example:

"1 Infinite Loop"

data.values.primary_location.line_2

string | null

required

The second line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.

Example:

"Block 1"

data.values.primary_location.line_3

string | null

required

The third line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.

Example:

"Hilldrop Estate"

data.values.primary_location.line_4

string | null

required

The fourth line of the address. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.

Example:

"Westborough"

data.values.primary_location.locality

string | null

required

The town, neighborhood or area the location is in.

Example:

"Cupertino"

data.values.primary_location.region

string | null

required

The state, county, province or region that the location is in.

Example:

"CA"

data.values.primary_location.postcode

string | null

required

The postcode or zip code for the location. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}

Example:

"95014"

data.values.primary_location.country_code

enum<string> | null

required

The ISO 3166-1 alpha-2 country code for the country this location is in.

Available options:

AF,

AX,

AL,

DZ,

AS,

AD,

AO,

AI,

AQ,

AG,

AR,

AM,

AW,

AU,

AT,

AZ,

BS,

BH,

BD,

BB,

BY,

BE,

BZ,

BJ,

BM,

BT,

BO,

BA,

BW,

BV,

BR,

IO,

BN,

BG,

BF,

BI,

KH,

CM,

CA,

CV,

KY,

CF,

TD,

CL,

CN,

CX,

CC,

CO,

KM,

CG,

CD,

CK,

CR,

CI,

HR,

CU,

CW,

CY,

CZ,

DK,

DJ,

DM,

DO,

EC,

EG,

SV,

GQ,

ER,

EE,

ET,

FK,

FO,

FJ,

FI,

FR,

GF,

PF,

TF,

GA,

GM,

GE,

DE,

GH,

GI,

GR,

GL,

GD,

GP,

GU,

GT,

GG,

GN,

GW,

GY,

HT,

HM,

VA,

HN,

HK,

HU,

IS,

IN,

ID,

IR,

IQ,

IE,

IM,

IL,

IT,

JM,

JP,

JE,

JO,

KZ,

KE,

KI,

KR,

KW,

KG,

LA,

LV,

LB,

LS,

LR,

LY,

LI,

LT,

LU,

MO,

MK,

MG,

MW,

MY,

MV,

ML,

MT,

MH,

MQ,

MR,

MU,

YT,

MX,

FM,

MD,

MC,

MN,

ME,

MS,

MA,

MZ,

MM,

NA,

NR,

NP,

NL,

AN,

NC,

NZ,

NI,

NE,

NG,

NU,

NF,

MP,

NO,

OM,

PK,

PW,

PS,

PA,

PG,

PY,

PE,

PH,

PN,

PL,

PT,

PR,

QA,

RE,

RO,

RU,

RW,

BL,

SH,

KN,

LC,

MF,

PM,

VC,

WS,

SM,

ST,

SA,

SN,

SS,

RS,

SC,

SL,

SG,

SK,

SI,

SB,

SO,

ZA,

GS,

ES,

LK,

SD,

SR,

SJ,

SZ,

SE,

CH,

SY,

TW,

TJ,

TZ,

TH,

TL,

TG,

TK,

TO,

TT,

TN,

TR,

TM,

TC,

TV,

UG,

UA,

AE,

GB,

US,

UM,

UY,

UZ,

VU,

VE,

VN,

VG,

VI,

WF,

EH,

YE,

ZM,

ZW

Example:

"US"

data.values.primary_location.latitude

string | null

required

Example:

"37.331741"

data.values.primary_location.longitude

string | null

required

The longitude of the location. Validated by the regular expression /^[-+]?(180(\.0+)?|((1[0-7]\d)|([1-9]?\d))(\.\d+)?)$/

Example:

"-122.030333"

data.values.primary_location.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

location

Example:

"location"

data.values.twitter_follower_count

object[]

data.values.twitter_follower_count.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.twitter_follower_count.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.twitter_follower_count.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.twitter_follower_count.value

number

required

Numbers are persisted as 64 bit floats.

Example:

42

data.values.twitter_follower_count.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

number

Example:

"number"

data.values.company

object[]

data.values.company.active_from

string

required

The point in time at which this value was made "active". active_from can be considered roughly analogous to created_at.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.company.active_until

string | null

required

The point in time at which this value was deactivated. If null, the value is active.

Example:

"2023-01-01T15:00:00.000000000Z"

data.values.company.created_by_actor

object

required

The actor that created this value.

Example:

{
  "type": "workspace-member",
  "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
}

data.values.company.target_object

string

required

A slug identifying the object that the referenced record belongs to.

Example:

"people"

data.values.company.target_record_id

string

required

A UUID to identify the referenced record.

Example:

"891dcbfc-9141-415d-9b2a-2238a6cc012d"

data.values.company.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

record-reference

Example:

"record-reference"

Example:

{
  "strongest_connection_strength_legacy": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": 54.725113205693695,
      "attribute_type": "number"
    }
  ],
  "last_interaction": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "interaction_type": "email",
      "interacted_at": "2023-01-01T15:00:00.000000000Z",
      "owner_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "attribute_type": "interaction"
    }
  ],
  "twitter": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": "https://x.com/johnsmith",
      "attribute_type": "text"
    }
  ],
  "avatar_url": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6",
      "attribute_type": "text"
    }
  ],
  "job_title": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": "Software Engineer",
      "attribute_type": "text"
    }
  ],
  "next_calendar_interaction": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "interaction_type": "email",
      "interacted_at": "2023-01-01T15:00:00.000000000Z",
      "owner_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "attribute_type": "interaction"
    }
  ],
  "company": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "target_object": "companies",
      "target_record_id": "f528bd86-8142-4359-9a8c-b651d50a27b1",
      "attribute_type": "record-reference"
    }
  ],
  "primary_location": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "line_1": "1 Infinite Loop",
      "line_2": null,
      "line_3": null,
      "line_4": null,
      "locality": "Cupertino",
      "region": "CA",
      "postcode": "95014",
      "country_code": "US",
      "latitude": "37.331741",
      "longitude": "-122.030333",
      "attribute_type": "location"
    }
  ],
  "angellist": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": "https://angellist.com/johnsmith",
      "attribute_type": "text"
    }
  ],
  "description": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "value": "Developer met at event",
      "attribute_type": "text"
    }
  ],
  "strongest_connection_user": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "referenced_actor_type": "workspace-member",
      "referenced_actor_id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64",
      "attribute_type": "actor-reference"
    }
  ],
  "strongest_connection_strength": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "option": {
        "id": {
          "workspace_id": "ca10906c-6785-464e-bb6c-b003e63c6a18",
          "object_id": "cf49cf53-dbb4-4d18-87fc-28aba21d7a49",
          "attribute_id": "7914c8c4-34b1-42b6-9e4c-4db8baa58bfa",
          "option_id": "e37175a9-94f3-410f-bb29-78287bc1c444"
        },
        "title": "Very strong",
        "is_archived": false
      },
      "attribute_type": "select"
    }
  ],
  "last_email_interaction": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "interaction_type": "email",
      "interacted_at": "2023-01-01T15:00:00.000000000Z",
      "owner_actor": {
        "type": "system",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "attribute_type": "interaction"
    }
  ],
  "email_addresses": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "original_email_address": "john-smith@attio.com",
      "email_address": "john-smith@attio.com",
      "email_domain": "attio.com",
      "email_root_domain": "attio.com",
      "email_local_specifier": "john-smith",
      "attribute_type": "email-address"
    }
  ],
  "first_interaction": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "interaction_type": "email",
      "interacted_at": "2023-01-01T15:00:00.000000000Z",
      "owner_actor": {
        "type": "system",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "attribute_type": "interaction"
    }
  ],
  "created_at": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": "2023-01-01T15:00:00.000000000Z",
      "attribute_type": "timestamp"
    }
  ],
  "created_by": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "referenced_actor_type": "workspace-member",
      "referenced_actor_id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64",
      "attribute_type": "actor-reference"
    }
  ],
  "last_calendar_interaction": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "interaction_type": "email",
      "interacted_at": "2023-01-01T15:00:00.000000000Z",
      "owner_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "attribute_type": "interaction"
    }
  ],
  "linkedin": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": "https://linkedin.com/in/johnsmith",
      "attribute_type": "text"
    }
  ],
  "facebook": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": "https://facebook.com/johnsmith",
      "attribute_type": "text"
    }
  ],
  "name": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "first_name": "John",
      "last_name": "Smith",
      "full_name": "John Smith",
      "attribute_type": "personal-name"
    }
  ],
  "first_calendar_interaction": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "interaction_type": "email",
      "interacted_at": "2023-01-01T15:00:00.000000000Z",
      "owner_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "attribute_type": "interaction"
    }
  ],
  "twitter_follower_count": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": 100,
      "attribute_type": "number"
    }
  ],
  "instagram": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "value": "https://instagram.com/johnsmith",
      "attribute_type": "text"
    }
  ],
  "first_email_interaction": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": { "type": "system", "id": null },
      "interaction_type": "email",
      "interacted_at": "2023-01-01T15:00:00.000000000Z",
      "owner_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "attribute_type": "interaction"
    }
  ],
  "phone_numbers": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "country_code": "US",
      "original_phone_number": "+15558675309",
      "phone_number": "+15558675309",
      "attribute_type": "phone-number"
    }
  ]
}

List person records Create a person Record

curl --request PUT \
  --url https://api.attio.com/v2/objects/people/records \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "values": {
      "email_addresses": [
        "john-smith@attio.com"
      ],
      "name": [
        {
          "first_name": "John",
          "last_name": "Smith",
          "full_name": "John Smith"
        }
      ],
      "description": "Developer met at event",
      "company": [
        {
          "target_object": "companies",
          "target_record_id": "99a03ff3-0435-47da-95cc-76b2caeb4dab"
        },
        {
          "target_object": "companies",
          "domains": [
            {
              "domain": "attio.com"
            }
          ]
        }
      ],
      "phone_numbers": [
        {
          "original_phone_number": "+15558675309",
          "country_code": "US"
        }
      ],
      "primary_location": [
        {
          "line_1": "1 Infinite Loop",
          "line_2": null,
          "line_3": null,
          "line_4": null,
          "locality": "Cupertino",
          "region": "CA",
          "postcode": "95014",
          "country_code": "US",
          "latitude": "37.331741",
          "longitude": "-122.030333"
        }
      ],
      "linkedin": "https://linkedin.com/in/johnsmith"
    }
  }
}'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
      "record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b"
    },
    "created_at": "2022-11-21T13:22:49.061281000Z",
    "values": {
      "strongest_connection_strength_legacy": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": 54.725113205693695,
          "attribute_type": "number"
        }
      ],
      "last_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "twitter": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://x.com/johnsmith",
          "attribute_type": "text"
        }
      ],
      "avatar_url": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/b792e7f9-003d-494f-a7b4-a53251c621e6",
          "attribute_type": "text"
        }
      ],
      "job_title": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "Software Engineer",
          "attribute_type": "text"
        }
      ],
      "next_calendar_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "company": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "target_object": "companies",
          "target_record_id": "f528bd86-8142-4359-9a8c-b651d50a27b1",
          "attribute_type": "record-reference"
        }
      ],
      "primary_location": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "line_1": "1 Infinite Loop",
          "line_2": null,
          "line_3": null,
          "line_4": null,
          "locality": "Cupertino",
          "region": "CA",
          "postcode": "95014",
          "country_code": "US",
          "latitude": "37.331741",
          "longitude": "-122.030333",
          "attribute_type": "location"
        }
      ],
      "angellist": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://angellist.com/johnsmith",
          "attribute_type": "text"
        }
      ],
      "description": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "value": "Developer met at event",
          "attribute_type": "text"
        }
      ],
      "strongest_connection_user": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "referenced_actor_type": "workspace-member",
          "referenced_actor_id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64",
          "attribute_type": "actor-reference"
        }
      ],
      "strongest_connection_strength": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "option": {
            "id": {
              "workspace_id": "ca10906c-6785-464e-bb6c-b003e63c6a18",
              "object_id": "cf49cf53-dbb4-4d18-87fc-28aba21d7a49",
              "attribute_id": "7914c8c4-34b1-42b6-9e4c-4db8baa58bfa",
              "option_id": "e37175a9-94f3-410f-bb29-78287bc1c444"
            },
            "title": "Very strong",
            "is_archived": false
          },
          "attribute_type": "select"
        }
      ],
      "last_email_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "system",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "email_addresses": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "original_email_address": "john-smith@attio.com",
          "email_address": "john-smith@attio.com",
          "email_domain": "attio.com",
          "email_root_domain": "attio.com",
          "email_local_specifier": "john-smith",
          "attribute_type": "email-address"
        }
      ],
      "first_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "system",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "created_at": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "2023-01-01T15:00:00.000000000Z",
          "attribute_type": "timestamp"
        }
      ],
      "created_by": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "referenced_actor_type": "workspace-member",
          "referenced_actor_id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64",
          "attribute_type": "actor-reference"
        }
      ],
      "last_calendar_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "linkedin": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://linkedin.com/in/johnsmith",
          "attribute_type": "text"
        }
      ],
      "facebook": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://facebook.com/johnsmith",
          "attribute_type": "text"
        }
      ],
      "name": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "first_name": "John",
          "last_name": "Smith",
          "full_name": "John Smith",
          "attribute_type": "personal-name"
        }
      ],
      "first_calendar_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "twitter_follower_count": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": 100,
          "attribute_type": "number"
        }
      ],
      "instagram": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "value": "https://instagram.com/johnsmith",
          "attribute_type": "text"
        }
      ],
      "first_email_interaction": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "system",
            "id": null
          },
          "interaction_type": "email",
          "interacted_at": "2023-01-01T15:00:00.000000000Z",
          "owner_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "attribute_type": "interaction"
        }
      ],
      "phone_numbers": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "country_code": "US",
          "original_phone_number": "+15558675309",
          "phone_number": "+15558675309",
          "attribute_type": "phone-number"
        }
      ]
    }
  }
}

People

Companies

Users

Deals

Workspaces

Assert a person Record

Authorizations

Query Parameters

Body

Response