Create an object

curl --request POST \
  --url https://api.attio.com/v2/objects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "api_slug": "people",
    "singular_noun": "Person",
    "plural_noun": "People"
  }
}
'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795"
    },
    "api_slug": "people",
    "singular_noun": "Person",
    "plural_noun": "People",
    "created_at": "2022-11-21T13:22:49.061281000Z"
  }
}

POST

objects

Create an object

curl --request POST \
  --url https://api.attio.com/v2/objects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "api_slug": "people",
    "singular_noun": "Person",
    "plural_noun": "People"
  }
}
'

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795"
    },
    "api_slug": "people",
    "singular_noun": "Person",
    "plural_noun": "People",
    "created_at": "2022-11-21T13:22:49.061281000Z"
  }
}

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

string

required

A unique, human-readable slug to access the object through URLs and API calls. Should be formatted in snake case.

Example:

"people"

data.singular_noun

string

required

The singular form of the object's name.

Minimum string length: 1

Example:

"Person"

data.plural_noun

string

required

The plural form of the object's name.

Minimum string length: 1

Example:

"People"

Response

Success

data

object

required

Show child attributes

data.id

object

required

Show child attributes

data.id.workspace_id

string<uuid>

required

A UUID to identify the workspace this object belongs to.

Example:

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

data.id.object_id

string<uuid>

required

A UUID to identify the object.

Example:

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

data.api_slug

string | null

required

A unique, human-readable slug to access the object through URLs and API calls. Formatted in snake case.

Example:

"people"

data.singular_noun

string | null

required

The singular form of the object's name.

Example:

"Person"

data.plural_noun

string | null

required

The plural form of the object's name.

Example:

"People"

data.created_at

string

required

When the object was created.

Example:

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

List objects Get an object

⌘I

Introduction

Guides

Tutorials

Endpoint reference

Webhook reference

Create an object

Authorizations

Body

Response