Create a person Record

Authorizations

Authorization

string

header

required

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

Body

application/json

data

object

required

Show child attributes

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.

Show child attributes

data.values.email_addresses

object[]

Show child attributes

data.values.email_addresses.email_address

string

An email address string

Example:

"[email protected]"

data.values.name

object[]

Show child attributes

data.values.name.first_name

string

The first name.

Example:

"Ada"

data.values.name.last_name

string

The last name.

Example:

"Lovelace"

data.values.name.full_name

string

The full name.

Example:

"Ada Lovelace"

data.values.description

object[]

Show child attributes

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.avatar_url

object[]

Show child attributes

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.job_title

object[]

Show child attributes

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.phone_numbers

object[]

Show child attributes

data.values.phone_numbers.original_phone_number

string

required

A phone number which is either a) prefixed with a country code (e.g. +44....) or b) a local number, where country_code is specified in addition.

Example:

"+15558675309"

data.values.phone_numbers.country_code

enum<string> | null

The ISO 3166-1 alpha-2 country code representing the country that this phone number belongs to. Optional if original_phone_number includes a country code prefix.

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,

BQ,

KP,

SX,

XK,

AC

Example:

"GB"

data.values.linkedin

object[]

Show child attributes

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.twitter

object[]

Show child attributes

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.facebook

object[]

Show child attributes

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.instagram

object[]

Show child attributes

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.angellist

object[]

Show child attributes

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.primary_location

object[]

Show child attributes

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,

BQ,

KP,

SX,

XK,

AC

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+)?)$/. Values are stored with up to 9 decimal places of precision. 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+)?)$/. Values are stored with up to 9 decimal places of precision. Note that this value is not currently represented in the UI but will be persisted and readable through API calls.}

Example:

"-122.030333"

data.values.twitter_follower_count

object[]

Show child attributes

data.values.twitter_follower_count.value

number

required

Numbers are persisted as 64 bit floats.

Example:

42

data.values.company

object[]

Option 1
Option 2

Show child attributes

data.values.company.target_object

string

required

A UUID or slug to identify the object that the referenced record belongs to.

Example:

"people"

data.values.company.target_record_id

string<uuid>

required

A UUID to identify the referenced record.

Example:

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

Example:

{
  "target_object": "people",
  "target_record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
}

Example:

{
  "email_addresses": ["[email protected]"],
  "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

Success

data

object

required

Show child attributes

data.id

object

required

Show child attributes

data.id.workspace_id

string<uuid>

required

A UUID identifying the workspace this record belongs to.

Example:

"14beef7a-99f7-4534-a87e-70b564330a4c"

data.id.object_id

string<uuid>

required

A UUID identifying the object this record belongs to.

Example:

"97052eb9-e65e-443f-a297-f2d9a4a7f795"

data.id.record_id

string<uuid>

required

A UUID identifying this record.

Example:

"bf071e1f-6035-429d-b874-d83ea64ea13b"

data.created_at

string

required

When this record was created.

Example:

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

data.web_url

string<uri>

required

A URL that links directly to the record page in the Attio web application.

Example:

"https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b"

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.

Show child attributes

data.values.email_addresses

object[]

Show child attributes

data.values.email_addresses.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.email_addresses.created_by_actor.id

string | null

An ID to identify the actor.

data.values.email_addresses.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

Example:

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

data.values.email_addresses.original_email_address

string

required

Example:

"[email protected]"

data.values.email_addresses.email_address

string

required

Example:

"[email protected]"

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[]

Show child attributes

data.values.name.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.name.created_by_actor.id

string | null

An ID to identify the actor.

data.values.name.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.description.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.description.created_by_actor.id

string | null

An ID to identify the actor.

data.values.description.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.avatar_url.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.avatar_url.created_by_actor.id

string | null

An ID to identify the actor.

data.values.avatar_url.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.job_title.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.job_title.created_by_actor.id

string | null

An ID to identify the actor.

data.values.job_title.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.phone_numbers.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.phone_numbers.created_by_actor.id

string | null

An ID to identify the actor.

data.values.phone_numbers.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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,

BQ,

KP,

SX,

XK,

AC

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[]

Show child attributes

data.values.linkedin.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.linkedin.created_by_actor.id

string | null

An ID to identify the actor.

data.values.linkedin.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.twitter.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.twitter.created_by_actor.id

string | null

An ID to identify the actor.

data.values.twitter.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.facebook.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.facebook.created_by_actor.id

string | null

An ID to identify the actor.

data.values.facebook.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.instagram.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.instagram.created_by_actor.id

string | null

An ID to identify the actor.

data.values.instagram.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.angellist.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.angellist.created_by_actor.id

string | null

An ID to identify the actor.

data.values.angellist.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.primary_location.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.primary_location.created_by_actor.id

string | null

An ID to identify the actor.

data.values.primary_location.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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,

BQ,

KP,

SX,

XK,

AC

Example:

"US"

data.values.primary_location.latitude

string | null

required

Example:

"37.331741"

data.values.primary_location.longitude

string | null

required

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[]

Show child attributes

data.values.twitter_follower_count.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.twitter_follower_count.created_by_actor.id

string | null

An ID to identify the actor.

data.values.twitter_follower_count.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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[]

Show child attributes

data.values.company.active_from

string<date-time>

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<date-time> | 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.

Show child attributes

data.values.company.created_by_actor.id

string | null

An ID to identify the actor.

data.values.company.created_by_actor.type

enum<string> | null

The type of actor. Read more information on actor types here.

Available options:

api-token,

workspace-member,

system,

app

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<uuid>

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": "[email protected]",
      "email_address": "[email protected]",
      "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": []
}

Introduction

Guides

Tutorials

Endpoint reference

Webhook reference

Create a person Record

Authorizations

Body

Response