Create a company record

Creates a new company record. This endpoint will throw on conflicts of unique attributes, like domains. If you would prefer to update company records on conflicts, please use the Assert company record endpoint instead. Please note, the logo_url attribute cannot currently be set via the API.

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

POST /v2/objects/companies/records

Create a company record

cURL

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": [
        "[e-mail]"
      ],
      "primary_location": "1 Infinite Loop, Cupertino, CA, 95014, US"
    }
  }
}
'

200

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

Show child attributes

Response

200

application/json

Success

Success

data · object · required

Show child attributes