ATattio
Records

Create a record

Changed on

Creates a new person, company or other record. This endpoint will throw on conflicts of unique attributes. If you would prefer to update records on conflicts, please use the Upsert record endpoint instead.

Required scopes: record_permission:read-write, object_configuration:read.

Supported token levels: workspace, user.

post/v2/objects/{object}/records

Request

  • Base URL
    https://api.attio.com
  • URL
    https://api.attio.com/v2/objects/{object}/records
  • Auth
    OAuth 2
    Authorization code: https://app.attio.com/authorize
    Token URL: https://app.attio.com/oauth/token scopes: record_permission:read-write, object_configuration:read

Path parameters

objectstring required

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

Example:people

Request body

Example request

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

Response

Success

Example response

{
  "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"
  }
}

Changes

  • 81e667ad2d75Revision changes
    • breaking

      the response's property type changed from string to no type for status

    • info

      added subschema #1 subschema #2 subschema #3 to the response property anyOf list for the response status

    • info

      added subschema #3 subschema #4 subschema #5 subschema #6 to the response property anyOf list for the response status

    • info

      removed the concurrent_write_conflict enum value from the response property for the response status

  • 2ce18516bfdbRevision changes
    • breaking

      the response's property type changed from string to no type for status

    • info

      added the non-success response with the status

    • info

      added subschema #1 subschema #2 to the response property anyOf list for the response status

    • info

      removed the value_not_found enum value from the response property for the response status