Create a person Record

POST

objects

people

records

curl --request POST \
  --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": {
      "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"
        }
      ],
      "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"
        }
      ],
      "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"
        }
      ],
      "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"
        }
      ],
      "strongest_connection_strength_legacy": [],
      "last_interaction": [],
      "twitter": [],
      "avatar_url": [],
      "job_title": [],
      "next_calendar_interaction": [],
      "company": [],
      "primary_location": [],
      "angellist": [],
      "strongest_connection_user": [],
      "strongest_connection_strength": [],
      "last_email_interaction": [],
      "first_interaction": [],
      "last_calendar_interaction": [],
      "linkedin": [],
      "facebook": [],
      "first_calendar_interaction": [],
      "twitter_follower_count": [],
      "instagram": [],
      "first_email_interaction": [],
      "phone_numbers": []
    }
  }
}

Authorizations

Authorization

string

header

required

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

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:

{
  "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"
    }
  ],
  "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"
    }
  ],
  "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"
    }
  ],
  "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"
    }
  ],
  "strongest_connection_strength_legacy": [],
  "last_interaction": [],
  "twitter": [],
  "avatar_url": [],
  "job_title": [],
  "next_calendar_interaction": [],
  "company": [],
  "primary_location": [],
  "angellist": [],
  "strongest_connection_user": [],
  "strongest_connection_strength": [],
  "last_email_interaction": [],
  "first_interaction": [],
  "last_calendar_interaction": [],
  "linkedin": [],
  "facebook": [],
  "first_calendar_interaction": [],
  "twitter_follower_count": [],
  "instagram": [],
  "first_email_interaction": [],
  "phone_numbers": []
}

Assert a person Record Get a person Record

curl --request POST \
  --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": {
      "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"
        }
      ],
      "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"
        }
      ],
      "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"
        }
      ],
      "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"
        }
      ],
      "strongest_connection_strength_legacy": [],
      "last_interaction": [],
      "twitter": [],
      "avatar_url": [],
      "job_title": [],
      "next_calendar_interaction": [],
      "company": [],
      "primary_location": [],
      "angellist": [],
      "strongest_connection_user": [],
      "strongest_connection_strength": [],
      "last_email_interaction": [],
      "first_interaction": [],
      "last_calendar_interaction": [],
      "linkedin": [],
      "facebook": [],
      "first_calendar_interaction": [],
      "twitter_follower_count": [],
      "instagram": [],
      "first_email_interaction": [],
      "phone_numbers": []
    }
  }
}

People

Companies

Users

Deals

Workspaces

Create a person Record

Authorizations

Body

Response