Companies

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

Request

Base URL
https://api.attio.com
URL
https://api.attio.com/v2/objects/companies/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

Request body

Example request

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

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",
    "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": []
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.