Create a record

curl --request POST \
  --url https://api.attio.com/v2/objects/{object}/records \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "values": {
      "41252299-f8c7-4b5e-99c9-4ff8321d2f96": "Text value",
      "multiselect_attribute": [
        "Select option 1",
        "Select option 2"
      ]
    }
  }
}
'

{
  "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",
    "web_url": "https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b",
    "values": {}
  }
}

POST

objects

{object}

records

Create a record

curl --request POST \
  --url https://api.attio.com/v2/objects/{object}/records \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "values": {
      "41252299-f8c7-4b5e-99c9-4ff8321d2f96": "Text value",
      "multiselect_attribute": [
        "Select option 1",
        "Select option 2"
      ]
    }
  }
}
'

{
  "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",
    "web_url": "https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b",
    "values": {}
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

object

string

required

The UUID or slug identifying the object the created record should belong to.

Example:

"people"

Body

application/json

data

object

required

Show child attributes

data.values

object

required

An object with an attribute api_slug or attribute_id as the key, and a single value (for single-select attributes), or an array of values (for single or multi-select attributes) as the values. For complete documentation on values for all attribute types, please see our attribute type docs.

Show child attributes

data.values.{key}

array

Example:

{
  "41252299-f8c7-4b5e-99c9-4ff8321d2f96": "Text value",
  "multiselect_attribute": ["Select option 1", "Select option 2"]
}

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

A record type with an attribute api_slug as the key, and an array of value objects as the values.

Show child attributes

data.values.{key}

object[]

Option 1
Option 2
Option 3
Option 4
Option 5
Option 6
Option 7
Option 8
Option 9
Option 10
Option 11
Option 12
Option 13
Option 14
Option 15
Option 16
Option 17

Show child attributes

data.values.{key}.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.{key}.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.{key}.created_by_actor

object

required

The actor that created this value.

Show child attributes

data.values.{key}.created_by_actor.id

string | null

An ID to identify the actor.

data.values.{key}.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.{key}.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.{key}.referenced_actor_id

string<uuid> | null

required

The ID of the referenced actor.

Example:

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

data.values.{key}.attribute_type

enum<string>

required

The attribute type of the value.

Available options:

actor-reference

Example:

"actor-reference"

Assert a record Get a record

⌘I

Introduction

Guides

Tutorials

Endpoint reference

Webhook reference

Create a record

Authorizations

Path Parameters

Body

Response