Authorizations
This API uses OAuth 2.0 with the authorization code grant flow.
Body
application/json
Response
Success
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": [
"alice@attio.com"
],
"primary_location": "1 Infinite Loop, Cupertino, CA, 95014, US"
}
}
}'{
"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": []
}
}
}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.
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": [
"alice@attio.com"
],
"primary_location": "1 Infinite Loop, Cupertino, CA, 95014, US"
}
}
}'{
"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": []
}
}
}This API uses OAuth 2.0 with the authorization code grant flow.
Show child attributes
Success
Show child attributes
Was this page helpful?