Create a company record

POST

objects

companies

records

curl --request POST \
  --url https://api.attio.com/v2/objects/companies/records \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "values": {
      "domains": [
        "attio.com"
      ],
      "name": "Attio",
      "description": "Customer relationship magic",
      "team": [
        "alice@attio.com"
      ],
      "primary_location": "1 Infinite Loop, Cupertino, CA, 95014, US"
    }
  }
}'

{
  "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": {
      "domains": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "domain": "attio.com",
          "root_domain": "attio.com",
          "attribute_type": "domain"
        }
      ],
      "name": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "value": "Attio",
          "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": "Customer relationship magic",
          "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"
        }
      ],
      "twitter": [],
      "team": [],
      "primary_location": [],
      "last_email_interaction": [],
      "categories": [],
      "logo_url": [],
      "twitter_follower_count": [],
      "last_calendar_interaction": [],
      "linkedin": [],
      "foundation_date": [],
      "strongest_connection_user": [],
      "estimated_arr_usd": [],
      "strongest_connection_strength_legacy": [],
      "next_calendar_interaction": [],
      "employee_range": [],
      "first_interaction": [],
      "angellist": [],
      "facebook": [],
      "first_email_interaction": [],
      "strongest_connection_strength": [],
      "first_calendar_interaction": [],
      "instagram": [],
      "last_interaction": []
    }
  }
}

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 company attribute. For information on potential custom attributes, refer to our attribute type docs.

data.values.domains

object[]

data.values.name

object[]

data.values.description

object[]

data.values.twitter

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

object[]

data.values.logo_url

object[]

data.values.twitter_follower_count

object[]

data.values.linkedin

object[]

data.values.foundation_date

object[]

data.values.estimated_arr_usd

object[]

data.values.employee_range

object[]

data.values.angellist

object[]

data.values.facebook

object[]

data.values.instagram

object[]

data.values.team

object[]

Example:

{
  "domains": ["attio.com"],
  "name": "Attio",
  "description": "Customer relationship magic",
  "team": ["alice@attio.com"],
  "primary_location": "1 Infinite Loop, Cupertino, CA, 95014, US"
}

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 domains or name) can be used, including custom attribute slugs.

data.values.domains

object[]

data.values.domains.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.domains.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.domains.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.domains.domain

string

required

Example:

"app.attio.com"

data.values.domains.root_domain

string

required

Example:

"attio.com"

data.values.domains.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

domain

Example:

"domain"

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.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.name.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

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

object[]

data.values.team.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.team.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.team.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.team.target_object

string

required

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

Example:

"people"

data.values.team.target_record_id

string

required

A UUID to identify the referenced record.

Example:

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

data.values.team.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

record-reference

Example:

"record-reference"

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

object[]

data.values.last_email_interaction.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.last_email_interaction.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.last_email_interaction.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.last_email_interaction.interaction_type

enum<string>

required

The type of interaction e.g. calendar or email.

Available options:

calendar-event,

call,

chat-thread,

email,

in-person-meeting,

meeting

Example:

"email"

data.values.last_email_interaction.interacted_at

string

required

When the interaction occurred.

Example:

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

data.values.last_email_interaction.owner_actor

object

required

The actor that created this value.

Example:

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

data.values.last_email_interaction.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

interaction

Example:

"interaction"

data.values.categories

object[]

data.values.categories.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.categories.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.categories.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.categories.option

object

required

data.values.categories.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

select

Example:

"select"

data.values.logo_url

object[]

data.values.logo_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.logo_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.logo_url.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.logo_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.logo_url.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

text

Example:

"text"

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

object[]

data.values.last_calendar_interaction.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.last_calendar_interaction.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.last_calendar_interaction.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.last_calendar_interaction.interaction_type

enum<string>

required

The type of interaction e.g. calendar or email.

Available options:

calendar-event,

call,

chat-thread,

email,

in-person-meeting,

meeting

Example:

"email"

data.values.last_calendar_interaction.interacted_at

string

required

When the interaction occurred.

Example:

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

data.values.last_calendar_interaction.owner_actor

object

required

The actor that created this value.

Example:

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

data.values.last_calendar_interaction.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

interaction

Example:

"interaction"

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

object[]

data.values.foundation_date.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.foundation_date.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.foundation_date.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.foundation_date.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

date

Example:

"date"

data.values.foundation_date.value

string

required

A date represents a single calendar year, month and day, independent of timezone. If hours, months, seconds or timezones are provided, they will be trimmed. For example, "2023" and "2023-01" will be coerced into "2023-01-01", and "2023-01-02", "2023-01-02T13:00", "2023-01-02T14:00:00", "2023-01-02T15:00:00.000000000", and "2023-01-02T15:00:00.000000000+02:00" will all be coerced to "2023-01-02". If a timezone is provided that would result in a different calendar date in UTC, the date will be coerced to UTC and then the timezone component will be trimmed. For example, the value "2023-01-02T23:00:00-10:00" will be returned as "2023-01-03". The maximum date is "9999-12-31".

Example:

"2023-01-01"

data.values.strongest_connection_user

object[]

data.values.strongest_connection_user.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.strongest_connection_user.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.strongest_connection_user.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.strongest_connection_user.referenced_actor_type

enum<string>

required

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

Available options:

api-token,

workspace-member,

system,

app

Example:

"workspace-member"

data.values.strongest_connection_user.referenced_actor_id

string | null

required

The ID of the referenced actor.

Example:

"50cf242c-7fa3-4cad-87d0-75b1af71c57b"

data.values.strongest_connection_user.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

actor-reference

Example:

"actor-reference"

data.values.estimated_arr_usd

object[]

data.values.estimated_arr_usd.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.estimated_arr_usd.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.estimated_arr_usd.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.estimated_arr_usd.option

object

required

data.values.estimated_arr_usd.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

select

Example:

"select"

data.values.strongest_connection_strength_legacy

object[]

data.values.strongest_connection_strength_legacy.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.strongest_connection_strength_legacy.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.strongest_connection_strength_legacy.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.strongest_connection_strength_legacy.value

number

required

Numbers are persisted as 64 bit floats.

Example:

42

data.values.strongest_connection_strength_legacy.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

number

Example:

"number"

data.values.next_calendar_interaction

object[]

data.values.next_calendar_interaction.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.next_calendar_interaction.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.next_calendar_interaction.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.next_calendar_interaction.interaction_type

enum<string>

required

The type of interaction e.g. calendar or email.

Available options:

calendar-event,

call,

chat-thread,

email,

in-person-meeting,

meeting

Example:

"email"

data.values.next_calendar_interaction.interacted_at

string

required

When the interaction occurred.

Example:

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

data.values.next_calendar_interaction.owner_actor

object

required

The actor that created this value.

Example:

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

data.values.next_calendar_interaction.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

interaction

Example:

"interaction"

data.values.employee_range

object[]

data.values.employee_range.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.employee_range.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.employee_range.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.employee_range.option

object

required

data.values.employee_range.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

select

Example:

"select"

data.values.first_interaction

object[]

data.values.first_interaction.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.first_interaction.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.first_interaction.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.first_interaction.interaction_type

enum<string>

required

The type of interaction e.g. calendar or email.

Available options:

calendar-event,

call,

chat-thread,

email,

in-person-meeting,

meeting

Example:

"email"

data.values.first_interaction.interacted_at

string

required

When the interaction occurred.

Example:

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

data.values.first_interaction.owner_actor

object

required

The actor that created this value.

Example:

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

data.values.first_interaction.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

interaction

Example:

"interaction"

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

object[]

data.values.first_email_interaction.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.first_email_interaction.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.first_email_interaction.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.first_email_interaction.interaction_type

enum<string>

required

The type of interaction e.g. calendar or email.

Available options:

calendar-event,

call,

chat-thread,

email,

in-person-meeting,

meeting

Example:

"email"

data.values.first_email_interaction.interacted_at

string

required

When the interaction occurred.

Example:

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

data.values.first_email_interaction.owner_actor

object

required

The actor that created this value.

Example:

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

data.values.first_email_interaction.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

interaction

Example:

"interaction"

data.values.strongest_connection_strength

object[]

data.values.strongest_connection_strength.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.strongest_connection_strength.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.strongest_connection_strength.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.strongest_connection_strength.option

object

required

data.values.strongest_connection_strength.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

select

Example:

"select"

data.values.first_calendar_interaction

object[]

data.values.first_calendar_interaction.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.first_calendar_interaction.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.first_calendar_interaction.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.first_calendar_interaction.interaction_type

enum<string>

required

The type of interaction e.g. calendar or email.

Available options:

calendar-event,

call,

chat-thread,

email,

in-person-meeting,

meeting

Example:

"email"

data.values.first_calendar_interaction.interacted_at

string

required

When the interaction occurred.

Example:

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

data.values.first_calendar_interaction.owner_actor

object

required

The actor that created this value.

Example:

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

data.values.first_calendar_interaction.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

interaction

Example:

"interaction"

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

object[]

data.values.last_interaction.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.last_interaction.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.last_interaction.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.last_interaction.interaction_type

enum<string>

required

The type of interaction e.g. calendar or email.

Available options:

calendar-event,

call,

chat-thread,

email,

in-person-meeting,

meeting

Example:

"email"

data.values.last_interaction.interacted_at

string

required

When the interaction occurred.

Example:

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

data.values.last_interaction.owner_actor

object

required

The actor that created this value.

Example:

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

data.values.last_interaction.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

interaction

Example:

"interaction"

data.values.created_at

object[]

data.values.created_at.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.created_at.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.created_at.created_by_actor

object

required

The actor that created this value.

Example:

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

data.values.created_at.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

timestamp

Example:

"timestamp"

data.values.created_at.value

string

required

A timestamp value represents a single, universal moment in time using an ISO 8601 formatted string. This means that a timestamp consists of a date, a time (with nanosecond precision), and a time zone. Attio will coerce timestamps which do not provide full nanosecond precision and UTC is assumed if no time zone is provided. For example, "2023", "2023-01", "2023-01-02", "2023-01-02T13:00", "2023-01-02T13:00:00", and "2023-01-02T13:00:00.000000000" will all be coerced to "2023-01-02T13:00:00.000000000Z". Timestamps are always returned in UTC. For example, writing a timestamp value using the string "2023-01-02T13:00:00.000000000+02:00" will result in the value "2023-01-02T11:00:00.000000000Z" being returned. The maximum date is "9999-12-31T23:59:59.999999999Z".

Example:

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

Example:

{
  "domains": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "domain": "attio.com",
      "root_domain": "attio.com",
      "attribute_type": "domain"
    }
  ],
  "name": [
    {
      "active_from": "2023-01-01T15:00:00.000000000Z",
      "active_until": null,
      "created_by_actor": {
        "type": "workspace-member",
        "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
      },
      "value": "Attio",
      "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": "Customer relationship magic",
      "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"
    }
  ],
  "twitter": [],
  "team": [],
  "primary_location": [],
  "last_email_interaction": [],
  "categories": [],
  "logo_url": [],
  "twitter_follower_count": [],
  "last_calendar_interaction": [],
  "linkedin": [],
  "foundation_date": [],
  "strongest_connection_user": [],
  "estimated_arr_usd": [],
  "strongest_connection_strength_legacy": [],
  "next_calendar_interaction": [],
  "employee_range": [],
  "first_interaction": [],
  "angellist": [],
  "facebook": [],
  "first_email_interaction": [],
  "strongest_connection_strength": [],
  "first_calendar_interaction": [],
  "instagram": [],
  "last_interaction": []
}

Assert a company record Get a company record

curl --request POST \
  --url https://api.attio.com/v2/objects/companies/records \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "values": {
      "domains": [
        "attio.com"
      ],
      "name": "Attio",
      "description": "Customer relationship magic",
      "team": [
        "alice@attio.com"
      ],
      "primary_location": "1 Infinite Loop, Cupertino, CA, 95014, US"
    }
  }
}'

{
  "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": {
      "domains": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "domain": "attio.com",
          "root_domain": "attio.com",
          "attribute_type": "domain"
        }
      ],
      "name": [
        {
          "active_from": "2023-01-01T15:00:00.000000000Z",
          "active_until": null,
          "created_by_actor": {
            "type": "workspace-member",
            "id": "a976f6a9-fc2b-4acb-91e7-afb2d18b4e64"
          },
          "value": "Attio",
          "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": "Customer relationship magic",
          "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"
        }
      ],
      "twitter": [],
      "team": [],
      "primary_location": [],
      "last_email_interaction": [],
      "categories": [],
      "logo_url": [],
      "twitter_follower_count": [],
      "last_calendar_interaction": [],
      "linkedin": [],
      "foundation_date": [],
      "strongest_connection_user": [],
      "estimated_arr_usd": [],
      "strongest_connection_strength_legacy": [],
      "next_calendar_interaction": [],
      "employee_range": [],
      "first_interaction": [],
      "angellist": [],
      "facebook": [],
      "first_email_interaction": [],
      "strongest_connection_strength": [],
      "first_calendar_interaction": [],
      "instagram": [],
      "last_interaction": []
    }
  }
}

People

Companies

Users

Deals

Workspaces

Create a company record

Authorizations

Body

Response