NAV
shell javascript

Looking for new docs?

Go to V2 docs

👋 Introduction

Thank you for deciding to read the Attio API Reference!

Our API is designed to make it easy to interact with the data inside of Attio using automated systems.

We have tried to make the Attio API as friendly as possible to developers by using standard REST conventions and JSON responses.

👩‍🏫 Developer Support

As Developers we understand that no API Reference can answer every question.

If you have a question about our API just start a conversation with us using the chat widget on this page and your query will be sent to a member of our team!

🔑 Authentication

API Keys

curl "https://api.attio.com"
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:  

import Attio from "attio"

const attioClient = new Attio("aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447")

The Attio API uses API keys to identify and authorise calls to the developer API.

These tokens are managed through the Workspace Admin settings inside
the Attio product.

Your API keys are able to authenticate to Attio and perform actions on your account so it's important that you keep them safe in the same way that you would a password.

We accept both Bearer and Basic HTTP Authentication. We recommend using Bearer Authentication.

If you are using HTTP Basic Authentication you should provide your API key as the Basic Authentication username. You can safely leave the password blank.

If you are using HTTP Bearer Authentication you should provide your API key in the Authorization header as the Bearer value.

To keep your API key secure you should always connect to the Attio API using HTTPS.

Scopes

We group endpoints into families of similar endpoints that we refer to as Scopes.

When creating a token you will need to select which scopes you want the token to possess.

A token can only be used on the endpoints which it has been scoped for. Attempting to use an insufficiently scoped token will result in an Authorization error.

🚨 Errors

The Attio API builds on top of HTTP Status Codes to show errors to developers.

Where appropriate the API will include a detailed error message explaining the nature of the issue and how it can be resolved.

Client Errors

These errors are the result of an error on the side of the developer and will need to be addressed in your own code.

We will normally include further information to help resolve the error in the JSON body of the response.

Error Code Description
400 The input provided to the method was invalid. The response body will contain more details to help resolve the issue.
401 The token provided was not accepted. This could be because the token has been revoked or is incorrectly formatted.
402 The workspace this token is connected to does not have an active subscription.
403 The token provided is not authorized for the scope required. The response body will contain details including the scope that was missing.
404 The resource requested could not be found.
429 The IP address making the request has exceeded our rate limits. The request should be retried in a few minutes.

Server Errors

These errors indicate that something went wrong in our systems.

Errors of this category will automatically trigger notifications to our team and we'll start working behind the scenes to address the issue.

Error Code Description
500 An error occurred processing the request. This is normally an application error and will not be solved by retrying the request.
503 Our servers are too busy to handle the request. This issue is normally temporary and will be solved by retrying the request in a few minutes.

💯 Versioning

Our APIs are versioned so that we can continue to safely improve our APIs without affecting your existing code.

When we release updates to our API we will do so, where possible, in a backwards compatible way so that implementations relying on functionality of the API version do not need to be upgraded.

If we ship a change to our APIs that is not backwards compatible we will do so by releasing a new major version of the API such that the old version continues to work as originally described.

Rarely, we might need to remove an old version of the API entirely. Whilst we will try not to do that we will always notify the Administrators of any accounts that have used the deprecated APIs in the 30 days leading up to the deprecation.

Historic Documentation

We only provide documentation for the most recent version of our endpoints.

If you need to access information relating to a previous version of the endpoint please contact Developer Support.

🚦 Rate Limiting

As a multi-tenant service provider we place restrictions on the amount of requests that a single client can generate in order to provide a high quality of service to all of our customers.

By default, we apply a rate limit of 1000 requests per minute.

If your client exceeds this threshold it will be unable to make further requests until the rate limit resets.

When a rate limit is activated you will receive a 429 Too Many Requests response.

We also include a Retry-After Header in our response. The Header's value is the number of seconds remaining until the rate limit resets and can be used to perform load management in your client side code.

📡 Receiving Webhooks

Attio allows developers to subscribe to HTTP notification called Webhooks.

Once a webhook is created, Attio will begin to call the nominated Webhook whenever the observed action takes place.

Attio conforms to the Rest Hooks Pattern - an open standard that allows for the dynamic management of Webhooks.

HTTPS

Webhooks must target URLs secured with HTTPS. This is because targeting URLs using HTTP reveals the confidential content of webhooks to the public internet. In addition to exposing your data to 'man in the middle' attacks, webhooks delivered via HTTP can be read at any point in the journey to your server, for example, by cloud providers or logging services. Ensuring your target URL is encrypted with HTTPS keeps your data secure.

Authenticating Webhooks

When receiving Webhooks it can be hard to know if the webhook you received was sent by us. To resolve this we attach a cryptographic signature to each webhook that we send so you can verify the origin of the request.

Attio includes two HTTP header called X-Attio-Signature and Attio-Signature.

The contents of both headers is always identical - the variations are provided to help traverse different HTTP server setups.

Calculating the Request Signature

echo '{"id": "1ec09c5b-8375-481a-b5cb-8118ce2f1523"}' | openssl dgst -sha256 -hmac aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447

const isVerified = attioClient.webhooks.verify('{"id": "1ec09c5b-8375-481a-b5cb-8118ce2f1523"}')

The Attio-Signature is calculated using a SHA256 HMAC of the request body using the API Key as the secret key.

We encode the Attio-Signature as a hexadecimal string.

We only sign the request body - which we interpret as a UTF-8 string.

Examples of how to generate the signature are provided in the column to the right.

Idempotency

Webhooks guarantee at-least-once message delivery, occasionally sending duplicate messages. To deduplicate messages, Attio includes an Idempotency-Key header which will be different for each message and the same between retries.

Delivery attempts

However, if you're receiving many duplicate messages, it may mean you're not acknowledging messages. Accepted HTTP response codes are within the 200-299 range (for example 200 or 202). If you answer with any other code, Attio will retry delivery of the message up to 10 times with an exponential back-off, which will happen over approximately 3 days in total; after which, the Webhook will be marked as degraded and we'll send you an email. If you answer with a 410 Gone, the Webhook will be disabled.

IP Addresses

Attio delivers Webhooks from a fixed set of IP Addresses.

In some environments with restrictive firewalls it might be necessary to allowlist these IPs.

34.76.181.69/32
35.189.212.204/32
35.190.200.137/32
104.199.25.43/32
35.205.134.181/32
34.77.170.251/32
104.155.38.31/32
35.240.20.227/32
35.205.218.25/32
34.77.63.171/32
35.195.180.236/32
104.199.20.44/32
34.78.73.25/32
34.77.104.7/32
35.205.250.54/32
34.78.179.95/32
35.189.210.201/32
34.77.106.144/32
104.155.115.39/32
34.78.11.169/32
35.241.187.180/32
35.240.124.129/32
35.241.222.75/32
35.195.62.68/32

34.76.181.69/32
35.189.212.204/32
35.190.200.137/32
104.199.25.43/32
35.205.134.181/32
34.77.170.251/32
104.155.38.31/32
35.240.20.227/32
35.205.218.25/32
34.77.63.171/32
35.195.180.236/32
104.199.20.44/32
34.78.73.25/32
34.77.104.7/32
35.205.250.54/32
34.78.179.95/32
35.189.210.201/32
34.77.106.144/32
104.155.115.39/32
34.78.11.169/32
35.241.187.180/32
35.240.124.129/32
35.241.222.75/32
35.195.62.68/32

Our current Webhook IP Addresses are:

An IPV4 (CIDR Notation) text list is also provided in the code browser.

🔐 Token Metadata

Show Current Token

Example Request

curl https://api.attio.com/v1/token \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:

Example Response (Status Code 200)

{
    "id": "1206f6bc-a803-499a-ad75-819ba7884024",
    "workspace": {
        "id": "d8baa3e5-c2ef-42e1-898c-c878e78575d3",
        "name": "Uber",
        "slug": "uber",
        "logo_url": "https://res-5.cloudinary.com/crunchbase-production/image/upload/c_lpad,h_120,w_120,f_auto,b_white,q_auto:eco/r3brbjf6y7thcnqhchq2"
    },
    "scopes": {
        "user_management": "read",
        "record_permission": "read-write",
        "public_collection": "disabled",
        "private_collection": "disabled",
        "task": "read",
        "note": "read-write",
        "webhook": "disabled"
    }
}

Retrieve information about the token being used and the Workspace to which it belongs.

Required Scopes

This endpoint does not require any scopes.

HTTP Request

Request Path

GET https://api.attio.com/v1/token

HTTP Response

Status Code - 200

Optional object
Show child properties
id
Required string
The Resource ID of the Current Token
workspace
Required object
An object containing information about the Workspace that the Token belongs to
Show child properties
id
Required string
The Resource ID of the Workspace
name
Required string
The Name of the Workspace
slug
Required string
The Unique Slug of the Workspace
logo_url
Optional string
A URL to the Logo Image of the Workspace
scopes
Required object
An object containing the scopes that have been granted to the token
Show child properties
user_management
Optional string
Show options
disabled read read-write
record_permission
Optional string
Show options
disabled read read-write
public_collection
Optional string
Show options
disabled read read-write
private_collection
Optional string
Show options
disabled read read-write
task
Optional string
Show options
disabled read read-write
note
Optional string
Show options
disabled read read-write
webhook
Optional string
Show options
disabled read read-write

🏢 Company Records

Assert Company Record

Example Request

curl https://api.attio.com/v1/companies \
    -X PUT \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:\
    -H application/json \
    -d '{"name":"Tesla Motors","description":"Tesla is an American electric vehicle company.","domains":["tesla.com"],"primary_location":{"city":"Palo Alto","state":"California","country_code":"US"},"social_media":{"twitter":"tesla","linkedin":"tesla-motors","facebook":"tesla","angellist":"tesla","instagram":"teslamotors"}}'

Example Response (Status Code 200)

{
    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
    "contact_type": "company",
    "name": "Tesla",
    "logo_url": "https://tesla.com/tesla-logo.png",
    "description": "Tesla is an American electric vehicle company.",
    "domains": [
        "tesla.com"
    ],
    "entries": {
        "95c341dc-7c46-430c-809c-1dbdda9aaf99": [
            {
                "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                "collection_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99"
            }
        ]
    },
    "primary_location": {
        "city": "Palo Alto",
        "state": "California",
        "country_name": "United States of America",
        "country_code": "US"
    },
    "social_media": {
        "twitter": {
            "handle": "tesla",
            "url": "https://twitter.com/tesla"
        },
        "linkedin": {
            "handle": "tesla-motors",
            "url": "https://www.linkedin.com/company/tesla-motors"
        },
        "facebook": {
            "handle": "tesla",
            "url": "https://www.facebook.com/instagram"
        },
        "angellist": {
            "handle": "tesla",
            "url": "https://angel.co/company/uber"
        },
        "instagram": {
            "handle": "teslamotors",
            "url": "https://www.instagram.com/teslamotors/"
        }
    },
    "communication_intelligence": {
        "last_contacted_at": "2020-01-27T10:23:10.162Z",
        "last_contacted_by": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        },
        "strongest_connection_strength": "GOOD",
        "strongest_connection_user": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        }
    },
    "roles": [
        {
            "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
            "company_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "company",
                "name": "Tesla"
            },
            "person_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "person",
                "first_name": "Elon",
                "last_name": "Musk"
            },
            "title": "CEO",
            "started_at": "2020-01-27T10:23:10.162Z",
            "ended_at": "2020-01-27T10:23:10.162Z",
            "created_by": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            },
            "created_at": "2020-01-27T10:23:10.162Z"
        }
    ],
    "created_at": "2020-01-27T10:23:10.162Z"
}

Example Response (Status Code 201)

{
    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
    "contact_type": "company",
    "name": "Tesla",
    "logo_url": "https://tesla.com/tesla-logo.png",
    "description": "Tesla is an American electric vehicle company.",
    "domains": [
        "tesla.com"
    ],
    "entries": {
        "95c341dc-7c46-430c-809c-1dbdda9aaf99": [
            {
                "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                "collection_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99"
            }
        ]
    },
    "primary_location": {
        "city": "Palo Alto",
        "state": "California",
        "country_name": "United States of America",
        "country_code": "US"
    },
    "social_media": {
        "twitter": {
            "handle": "tesla",
            "url": "https://twitter.com/tesla"
        },
        "linkedin": {
            "handle": "tesla-motors",
            "url": "https://www.linkedin.com/company/tesla-motors"
        },
        "facebook": {
            "handle": "tesla",
            "url": "https://www.facebook.com/instagram"
        },
        "angellist": {
            "handle": "tesla",
            "url": "https://angel.co/company/uber"
        },
        "instagram": {
            "handle": "teslamotors",
            "url": "https://www.instagram.com/teslamotors/"
        }
    },
    "communication_intelligence": {
        "last_contacted_at": "2020-01-27T10:23:10.162Z",
        "last_contacted_by": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        },
        "strongest_connection_strength": "GOOD",
        "strongest_connection_user": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        }
    },
    "roles": [
        {
            "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
            "company_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "company",
                "name": "Tesla"
            },
            "person_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "person",
                "first_name": "Elon",
                "last_name": "Musk"
            },
            "title": "CEO",
            "started_at": "2020-01-27T10:23:10.162Z",
            "ended_at": "2020-01-27T10:23:10.162Z",
            "created_by": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            },
            "created_at": "2020-01-27T10:23:10.162Z"
        }
    ],
    "created_at": "2020-01-27T10:23:10.162Z"
}

Create a company, if the company doesn't already exist. Existing companies are matched by their domains, as two companies cannot share the same domain. If no domain is provided, the company will always be created, as companies can share the same company name.

Required Scopes

Scope Required Level
Records Read-Write

HTTP Request

Request Path

PUT https://api.attio.com/v1/companies

Body Parameters

name
Optional string
Name of the company.
description
Optional string
Description of the Company.
domains
Optional array
Domains used by the company. This is an ordered list, as the domains are used for data enrichment.
Optional string
primary_location
Optional object
Primary location of the company.
Show child properties
city
Optional string
Name of the City.
state
Optional string
Name of the State.
country_code
Optional string
Alpha-2 ISO 3166 Country Code.
social_media
Optional object
Show child properties
twitter
Optional string
Twitter handle of the company.
linkedin
Optional string
Linked-In handle of the company.
facebook
Optional string
Facebook handle of the company.
angellist
Optional string
Angellist handle of the company.
instagram
Optional string
Instagram handle of the company.

HTTP Response

Status Code - 200

Required object
The HTTP status code will be 200 if the Company already existed.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
logo_url
Optional string
URL of the company logo.
description
Required string
Description of the Company.
domains
Required array
Domains used by the company. This is an ordered list, as the domains are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Company.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the company.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the company.
Show child properties
handle
Required string
Twitter handle of the company.
url
Required string
URL of the Twitter account of the company.
linkedin
Required object
Linked-In user information about the company.
Show child properties
handle
Required string
Linked-In handle of the company.
url
Required string
URL of the Linked-In account of the company.
facebook
Required object
Facebook user information about the company.
Show child properties
handle
Required string
Facebook handle of the company.
url
Required string
URL of the Facebook account of the company.
angellist
Required object
Angellist user information about the company.
Show child properties
handle
Required string
Angellist handle of the company.
url
Required string
URL of the Angellist account of the company.
instagram
Required object
Instagram user information about the company.
Show child properties
handle
Required string
Instagram handle of the company.
url
Required string
URL of the Instagram account of the company.
communication_intelligence
Required object
Communication information between your organization and the company.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the company.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the company and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the company.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the company.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this Record was created.

Status Code - 201

Required object
The HTTP status code will be 201 if the Company didn't exist and was created.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
logo_url
Optional string
URL of the company logo.
description
Required string
Description of the Company.
domains
Required array
Domains used by the company. This is an ordered list, as the domains are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Company.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the company.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the company.
Show child properties
handle
Required string
Twitter handle of the company.
url
Required string
URL of the Twitter account of the company.
linkedin
Required object
Linked-In user information about the company.
Show child properties
handle
Required string
Linked-In handle of the company.
url
Required string
URL of the Linked-In account of the company.
facebook
Required object
Facebook user information about the company.
Show child properties
handle
Required string
Facebook handle of the company.
url
Required string
URL of the Facebook account of the company.
angellist
Required object
Angellist user information about the company.
Show child properties
handle
Required string
Angellist handle of the company.
url
Required string
URL of the Angellist account of the company.
instagram
Required object
Instagram user information about the company.
Show child properties
handle
Required string
Instagram handle of the company.
url
Required string
URL of the Instagram account of the company.
communication_intelligence
Required object
Communication information between your organization and the company.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the company.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the company and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the company.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the company.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this Record was created.

Fetch Company Record

Example Request

curl https://api.attio.com/v1/companies/7cd94aa9-1dba-4814-88b6-c9c514dd259f \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:\
    -H application/json \
    -d '{}'

Example Response (Status Code 200)

{
    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
    "contact_type": "company",
    "name": "Tesla",
    "logo_url": "https://tesla.com/tesla-logo.png",
    "description": "Tesla is an American electric vehicle company.",
    "domains": [
        "tesla.com"
    ],
    "entries": {
        "95c341dc-7c46-430c-809c-1dbdda9aaf99": [
            {
                "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                "collection_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99"
            }
        ]
    },
    "primary_location": {
        "city": "Palo Alto",
        "state": "California",
        "country_name": "United States of America",
        "country_code": "US"
    },
    "social_media": {
        "twitter": {
            "handle": "tesla",
            "url": "https://twitter.com/tesla"
        },
        "linkedin": {
            "handle": "tesla-motors",
            "url": "https://www.linkedin.com/company/tesla-motors"
        },
        "facebook": {
            "handle": "tesla",
            "url": "https://www.facebook.com/instagram"
        },
        "angellist": {
            "handle": "tesla",
            "url": "https://angel.co/company/uber"
        },
        "instagram": {
            "handle": "teslamotors",
            "url": "https://www.instagram.com/teslamotors/"
        }
    },
    "communication_intelligence": {
        "last_contacted_at": "2020-01-27T10:23:10.162Z",
        "last_contacted_by": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        },
        "strongest_connection_strength": "GOOD",
        "strongest_connection_user": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        }
    },
    "roles": [
        {
            "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
            "company_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "company",
                "name": "Tesla"
            },
            "person_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "person",
                "first_name": "Elon",
                "last_name": "Musk"
            },
            "title": "CEO",
            "started_at": "2020-01-27T10:23:10.162Z",
            "ended_at": "2020-01-27T10:23:10.162Z",
            "created_by": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            },
            "created_at": "2020-01-27T10:23:10.162Z"
        }
    ],
    "created_at": "2020-01-27T10:23:10.162Z"
}

Returns a Company by its Resource ID.

Required Scopes

Scope Required Level
Records Read

HTTP Request

Request Path

GET https://api.attio.com/v1/companies/:company_id

URL Parameters

company_id
Required string
Resource ID of the Company.

HTTP Response

Status Code - 200

Required object
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
logo_url
Optional string
URL of the company logo.
description
Required string
Description of the Company.
domains
Required array
Domains used by the company. This is an ordered list, as the domains are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Company.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the company.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the company.
Show child properties
handle
Required string
Twitter handle of the company.
url
Required string
URL of the Twitter account of the company.
linkedin
Required object
Linked-In user information about the company.
Show child properties
handle
Required string
Linked-In handle of the company.
url
Required string
URL of the Linked-In account of the company.
facebook
Required object
Facebook user information about the company.
Show child properties
handle
Required string
Facebook handle of the company.
url
Required string
URL of the Facebook account of the company.
angellist
Required object
Angellist user information about the company.
Show child properties
handle
Required string
Angellist handle of the company.
url
Required string
URL of the Angellist account of the company.
instagram
Required object
Instagram user information about the company.
Show child properties
handle
Required string
Instagram handle of the company.
url
Required string
URL of the Instagram account of the company.
communication_intelligence
Required object
Communication information between your organization and the company.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the company.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the company and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the company.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the company.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this Record was created.

👩‍ Person Records

Assert Person Record

Example Request

curl https://api.attio.com/v1/people \
    -X PUT \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:\
    -H application/json \
    -d '{"first_name":"Elon","last_name":"Musk","description":"Elon Musk is an entrepreneur and founder of Tesla and SpaceX.","email_addresses":["[email protected]"],"primary_location":{"city":"Palo Alto","state":"California","country_code":"US"},"social_media":{"twitter":"elonmusk","linkedin":"elonmusk","facebook":"elonmusk","angellist":"elonmusk","instagram":"elonmusk"}}'

Example Response (Status Code 200)

{
    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
    "contact_type": "person",
    "first_name": "Elon",
    "last_name": "Musk",
    "avatar_url": "https://img.fullcontact.com/static/3dd17f95b6506dcec386c9afa298d442_8f82d7fc7af526a1ae066e4badb0d2efd404509aae3d3caf74176e346616fe4b",
    "description": "Elon Musk is an entrepreneur and founder of Tesla and SpaceX.",
    "email_addresses": [
        "[email protected]"
    ],
    "entries": {
        "95c341dc-7c46-430c-809c-1dbdda9aaf99": [
            {
                "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                "collection_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99"
            }
        ]
    },
    "primary_location": {
        "city": "Palo Alto",
        "state": "California",
        "country_name": "United States of America",
        "country_code": "US"
    },
    "social_media": {
        "twitter": {
            "handle": "elonmusk",
            "url": "https://twitter.com/elonmusk"
        },
        "linkedin": {
            "handle": "elonmusk",
            "url": "https://www.linkedin.com/in/elonmusk"
        },
        "facebook": {
            "handle": "elonmusk",
            "url": "https://www.facebook.com/elonmusk"
        },
        "angellist": {
            "handle": "elonmusk",
            "url": "https://angel.co/elonmusk"
        },
        "instagram": {
            "handle": "elonmusk",
            "url": "https://www.instagram.com/p/elonmusk/"
        }
    },
    "communication_intelligence": {
        "last_contacted_at": "2020-01-27T10:23:10.162Z",
        "last_contacted_by": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        },
        "strongest_connection_strength": "GOOD",
        "strongest_connection_user": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        }
    },
    "roles": [
        {
            "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
            "company_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "company",
                "name": "Tesla"
            },
            "person_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "person",
                "first_name": "Elon",
                "last_name": "Musk"
            },
            "title": "CEO",
            "started_at": "2020-01-27T10:23:10.162Z",
            "ended_at": "2020-01-27T10:23:10.162Z",
            "created_by": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            },
            "created_at": "2020-01-27T10:23:10.162Z"
        }
    ],
    "created_at": "2020-01-27T10:23:10.162Z"
}

Example Response (Status Code 201)

{
    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
    "contact_type": "person",
    "first_name": "Elon",
    "last_name": "Musk",
    "avatar_url": "https://img.fullcontact.com/static/3dd17f95b6506dcec386c9afa298d442_8f82d7fc7af526a1ae066e4badb0d2efd404509aae3d3caf74176e346616fe4b",
    "description": "Elon Musk is an entrepreneur and founder of Tesla and SpaceX.",
    "email_addresses": [
        "[email protected]"
    ],
    "entries": {
        "95c341dc-7c46-430c-809c-1dbdda9aaf99": [
            {
                "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                "collection_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99"
            }
        ]
    },
    "primary_location": {
        "city": "Palo Alto",
        "state": "California",
        "country_name": "United States of America",
        "country_code": "US"
    },
    "social_media": {
        "twitter": {
            "handle": "elonmusk",
            "url": "https://twitter.com/elonmusk"
        },
        "linkedin": {
            "handle": "elonmusk",
            "url": "https://www.linkedin.com/in/elonmusk"
        },
        "facebook": {
            "handle": "elonmusk",
            "url": "https://www.facebook.com/elonmusk"
        },
        "angellist": {
            "handle": "elonmusk",
            "url": "https://angel.co/elonmusk"
        },
        "instagram": {
            "handle": "elonmusk",
            "url": "https://www.instagram.com/p/elonmusk/"
        }
    },
    "communication_intelligence": {
        "last_contacted_at": "2020-01-27T10:23:10.162Z",
        "last_contacted_by": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        },
        "strongest_connection_strength": "GOOD",
        "strongest_connection_user": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        }
    },
    "roles": [
        {
            "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
            "company_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "company",
                "name": "Tesla"
            },
            "person_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "person",
                "first_name": "Elon",
                "last_name": "Musk"
            },
            "title": "CEO",
            "started_at": "2020-01-27T10:23:10.162Z",
            "ended_at": "2020-01-27T10:23:10.162Z",
            "created_by": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            },
            "created_at": "2020-01-27T10:23:10.162Z"
        }
    ],
    "created_at": "2020-01-27T10:23:10.162Z"
}

Create a person, if the person doesn't already exist. Existing people are matched by their email addresses, as two people cannot share the same email address. If no email address is provided, the person will always be created, as people can share the same name.

Required Scopes

Scope Required Level
Records Read-Write

HTTP Request

Request Path

PUT https://api.attio.com/v1/people

Body Parameters

first_name
Optional string
First name of the person.
last_name
Optional string
Last Name of the person.
description
Optional string
Description of the person.
email_addresses
Optional array
Email addresses used by the person. This is an ordered list, as the email addresses are used for data enrichment.
Optional string
primary_location
Optional object
Primary location of the person.
Show child properties
city
Optional string
Name of the City.
state
Optional string
Name of the State.
country_code
Optional string
Alpha-2 ISO 3166 Country Code.
social_media
Optional object
Show child properties
twitter
Optional string
Twitter handle of the person.
linkedin
Optional string
Linked-In handle of the person.
facebook
Optional string
Facebook handle of the person.
angellist
Optional string
Angellist handle of the person.
instagram
Optional string
Instagram handle of the person.

HTTP Response

Status Code - 200

Required object
The HTTP status code will be 200 if the Person already existed.
Show child properties
id
Required string
Resource ID of the person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the person.
last_name
Required string
Last Name of the person.
avatar_url
Optional string
URL of the person avatar.
description
Required string
Description of the person.
email_addresses
Required array
Email addresses used by the person. This is an ordered list, as the email addresses are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Person.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the person.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the person.
Show child properties
handle
Required string
Twitter handle of the person.
url
Required string
URL of the Twitter account of the person.
linkedin
Required object
Linked-In user information about the person.
Show child properties
handle
Required string
Linked-In handle of the person.
url
Required string
URL of the Twitter account of the person.
facebook
Required object
Facebook user information about the person.
Show child properties
handle
Required string
Facebook handle of the person.
url
Required string
URL of the Twitter account of the person.
angellist
Required object
Angellist user information about the person.
Show child properties
handle
Required string
Angellist handle of the person.
url
Required string
URL of the Twitter account of the person.
instagram
Required object
Instagram user information about the person.
Show child properties
handle
Required string
Instagram handle of the person.
url
Required string
URL of the Twitter account of the person.
communication_intelligence
Required object
Twitter user information about the person.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the person.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the person and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the person.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the person.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this record was created.

Status Code - 201

Required object
The HTTP status code will be 201 if the Person didn't exist and was created.
Show child properties
id
Required string
Resource ID of the person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the person.
last_name
Required string
Last Name of the person.
avatar_url
Optional string
URL of the person avatar.
description
Required string
Description of the person.
email_addresses
Required array
Email addresses used by the person. This is an ordered list, as the email addresses are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Person.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the person.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the person.
Show child properties
handle
Required string
Twitter handle of the person.
url
Required string
URL of the Twitter account of the person.
linkedin
Required object
Linked-In user information about the person.
Show child properties
handle
Required string
Linked-In handle of the person.
url
Required string
URL of the Twitter account of the person.
facebook
Required object
Facebook user information about the person.
Show child properties
handle
Required string
Facebook handle of the person.
url
Required string
URL of the Twitter account of the person.
angellist
Required object
Angellist user information about the person.
Show child properties
handle
Required string
Angellist handle of the person.
url
Required string
URL of the Twitter account of the person.
instagram
Required object
Instagram user information about the person.
Show child properties
handle
Required string
Instagram handle of the person.
url
Required string
URL of the Twitter account of the person.
communication_intelligence
Required object
Twitter user information about the person.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the person.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the person and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the person.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the person.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this record was created.

Fetch Person Record

Example Request

curl https://api.attio.com/v1/people/7cd94aa9-1dba-4814-88b6-c9c514dd259f \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:\
    -H application/json \
    -d '{}'

Example Response (Status Code 200)

{
    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
    "contact_type": "person",
    "first_name": "Elon",
    "last_name": "Musk",
    "avatar_url": "https://img.fullcontact.com/static/3dd17f95b6506dcec386c9afa298d442_8f82d7fc7af526a1ae066e4badb0d2efd404509aae3d3caf74176e346616fe4b",
    "description": "Elon Musk is an entrepreneur and founder of Tesla and SpaceX.",
    "email_addresses": [
        "[email protected]"
    ],
    "entries": {
        "95c341dc-7c46-430c-809c-1dbdda9aaf99": [
            {
                "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                "collection_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99"
            }
        ]
    },
    "primary_location": {
        "city": "Palo Alto",
        "state": "California",
        "country_name": "United States of America",
        "country_code": "US"
    },
    "social_media": {
        "twitter": {
            "handle": "elonmusk",
            "url": "https://twitter.com/elonmusk"
        },
        "linkedin": {
            "handle": "elonmusk",
            "url": "https://www.linkedin.com/in/elonmusk"
        },
        "facebook": {
            "handle": "elonmusk",
            "url": "https://www.facebook.com/elonmusk"
        },
        "angellist": {
            "handle": "elonmusk",
            "url": "https://angel.co/elonmusk"
        },
        "instagram": {
            "handle": "elonmusk",
            "url": "https://www.instagram.com/p/elonmusk/"
        }
    },
    "communication_intelligence": {
        "last_contacted_at": "2020-01-27T10:23:10.162Z",
        "last_contacted_by": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        },
        "strongest_connection_strength": "GOOD",
        "strongest_connection_user": {
            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
            "first_name": "Elon",
            "last_name": "Musk",
            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
            "email_address": "[email protected]",
            "is_admin": true,
            "is_suspended": false
        }
    },
    "roles": [
        {
            "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
            "company_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "company",
                "name": "Tesla"
            },
            "person_record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "person",
                "first_name": "Elon",
                "last_name": "Musk"
            },
            "title": "CEO",
            "started_at": "2020-01-27T10:23:10.162Z",
            "ended_at": "2020-01-27T10:23:10.162Z",
            "created_by": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            },
            "created_at": "2020-01-27T10:23:10.162Z"
        }
    ],
    "created_at": "2020-01-27T10:23:10.162Z"
}

Returns a Person by its Resource ID.

Required Scopes

Scope Required Level
Records Read

HTTP Request

Request Path

GET https://api.attio.com/v1/people/:person_id

URL Parameters

person_id
Required string
Resource ID of the Person.

HTTP Response

Status Code - 200

Required object
Show child properties
id
Required string
Resource ID of the person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the person.
last_name
Required string
Last Name of the person.
avatar_url
Optional string
URL of the person avatar.
description
Required string
Description of the person.
email_addresses
Required array
Email addresses used by the person. This is an ordered list, as the email addresses are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Person.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the person.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the person.
Show child properties
handle
Required string
Twitter handle of the person.
url
Required string
URL of the Twitter account of the person.
linkedin
Required object
Linked-In user information about the person.
Show child properties
handle
Required string
Linked-In handle of the person.
url
Required string
URL of the Twitter account of the person.
facebook
Required object
Facebook user information about the person.
Show child properties
handle
Required string
Facebook handle of the person.
url
Required string
URL of the Twitter account of the person.
angellist
Required object
Angellist user information about the person.
Show child properties
handle
Required string
Angellist handle of the person.
url
Required string
URL of the Twitter account of the person.
instagram
Required object
Instagram user information about the person.
Show child properties
handle
Required string
Instagram handle of the person.
url
Required string
URL of the Twitter account of the person.
communication_intelligence
Required object
Twitter user information about the person.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the person.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the person and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the person.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the person.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this record was created.

🙋 Users

List Users

Example Request

curl https://api.attio.com/v1/users \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:

Example Response (Status Code 200)

[
    {
        "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
        "first_name": "Elon",
        "last_name": "Musk",
        "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
        "email_address": "[email protected]",
        "is_admin": true,
        "is_suspended": false
    }
]

List all users.

Required Scopes

Scope Required Level
User Management Read

HTTP Request

Request Path

GET https://api.attio.com/v1/users

HTTP Response

Status Code - 200

Required array
Optional object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.

⌗ Entries

Create EntryBeta

Example Request

curl https://api.attio.com/v1/collections/7cd94aa9-1dba-4814-88b6-c9c514dd259f/entries \
    -X POST \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:\
    -H application/json \
    -d '{"record_type":"company","record_id":"11260103-b221-4013-b4e6-15843a403d43"}'

Example Response (Status Code 200)

{
    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
    "collection": {
        "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
        "name": "Fundraising",
        "is_public": true,
        "created_at": "2020-01-27T10:23:10.162Z",
        "members": [
            {
                "role": "read-only",
                "user": {
                    "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                    "first_name": "Elon",
                    "last_name": "Musk",
                    "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                    "email_address": "[email protected]",
                    "is_admin": true,
                    "is_suspended": false
                }
            }
        ],
        "attributes": [
            {
                "id": "d26d4f2e-b9a5-4587-8d11-bd0bd9383ac6",
                "collection_id": "b3dc767d-f861-47ad-acf1-046db449a8e0",
                "name": "Name of Attribute",
                "type": "text",
                "created_at": "2020-01-27T10:23:10.162Z"
            }
        ]
    },
    "record": {
        "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
        "contact_type": "company",
        "name": "Tesla",
        "logo_url": "https://tesla.com/tesla-logo.png",
        "description": "Tesla is an American electric vehicle company.",
        "domains": [
            "tesla.com"
        ],
        "entries": {
            "95c341dc-7c46-430c-809c-1dbdda9aaf99": [
                {
                    "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                    "collection_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99"
                }
            ]
        },
        "primary_location": {
            "city": "Palo Alto",
            "state": "California",
            "country_name": "United States of America",
            "country_code": "US"
        },
        "social_media": {
            "twitter": {
                "handle": "tesla",
                "url": "https://twitter.com/tesla"
            },
            "linkedin": {
                "handle": "tesla-motors",
                "url": "https://www.linkedin.com/company/tesla-motors"
            },
            "facebook": {
                "handle": "tesla",
                "url": "https://www.facebook.com/instagram"
            },
            "angellist": {
                "handle": "tesla",
                "url": "https://angel.co/company/uber"
            },
            "instagram": {
                "handle": "teslamotors",
                "url": "https://www.instagram.com/teslamotors/"
            }
        },
        "communication_intelligence": {
            "last_contacted_at": "2020-01-27T10:23:10.162Z",
            "last_contacted_by": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            },
            "strongest_connection_strength": "GOOD",
            "strongest_connection_user": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            }
        },
        "roles": [
            {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "company_record": {
                    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                    "contact_type": "company",
                    "name": "Tesla"
                },
                "person_record": {
                    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                    "contact_type": "person",
                    "first_name": "Elon",
                    "last_name": "Musk"
                },
                "title": "CEO",
                "started_at": "2020-01-27T10:23:10.162Z",
                "ended_at": "2020-01-27T10:23:10.162Z",
                "created_by": {
                    "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                    "first_name": "Elon",
                    "last_name": "Musk",
                    "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                    "email_address": "[email protected]",
                    "is_admin": true,
                    "is_suspended": false
                },
                "created_at": "2020-01-27T10:23:10.162Z"
            }
        ],
        "created_at": "2020-01-27T10:23:10.162Z"
    },
    "created_at": "2020-01-27T10:23:10.162Z",
    "attributes": {
        "e43067d7-48d6-450b-bb7e-a3affd2bda63": 227,
        "f2567717-6680-49c8-88c4-e084848119da": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
        "595e5b67-24b4-42a3-9817-070c447ae1ba": "2023-09-21T20:26:08.057Z",
        "95c341dc-7c46-430c-809c-1dbdda9aaf99": {
            "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
            "attribute_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99",
            "title": "Angel"
        },
        "801eb4ff-da66-4441-9b49-4483ffb4103e": [
            {
                "id": "eaf2290c-cf28-496a-97e5-e22c7cc25251",
                "attribute_id": "801eb4ff-da66-4441-9b49-4483ffb4103e",
                "title": "B"
            },
            {
                "id": "aeb0153e-45fe-486f-9cea-657e2b753b83",
                "attribute_id": "801eb4ff-da66-4441-9b49-4483ffb4103e",
                "title": "A"
            }
        ]
    }
}

Creates an Entry in a Collection.

Required Scopes

Scope Required Level
Public Collections Read-Write
Private Collections Read-Write

HTTP Request

Request Path

POST https://api.attio.com/v1/collections/:collection_id/entries

URL Parameters

collection_id
Required string
Resource ID of the Collection.

Body Parameters

record_type
Required string
Type of the Record.
Show options
person company
record_id
Required string
Resource ID of the Record.

HTTP Response

Status Code - 200

Required object
Show child properties
id
Required string
Resource ID of the Entry.
collection
Required object
Show child properties
id
Required string
Resource ID of the Collection.
name
Required string
Resource ID of the Collection.
is_public
Required boolean
Whether the Collection is public or private.
created_at
Required date
Date this Collection was created.
members
Required array
Optional object
Show child properties
role
Required string
Role of the Collection Member. On private collections, a read-write role is required to be able to modify the Collection.
Show options
read-only read-and-write full-access
user
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
attributes
Required array
List of Attributes for the Collection.
Optional alternatives
Show child properties
Optional object
Show child properties
id
Required string
Resource ID of the Attribute.
collection_id
Required string
Resource ID of the Collection.
name
Required string
Name of Attribute.
type
Required string
Attribute Type.
Show options
text number rating checkbox date currency multi-select-user record
created_at
Required date
Date this Attribute was created.
Optional object
Show child properties
id
Required string
Resource ID of the Attribute.
collection_id
Required string
Resource ID of the Collection.
name
Required string
Name of Attribute.
type
Required string
Attribute Type.
Show options
kanban-status
created_at
Required date
Date this Attribute was created.
kanban_stages
Required array
List of Kanban Stages. Property only present in the *kanban-status* attribute type.
Optional object
A Kanban Stage, part of a Kanban Attribute.
Show child properties
id
Required string
Resource ID of the Kanban Stage.
attribute_id
Required string
Resource ID of the Attribute.
name
Required string
Name of the Kanban Stage.
Optional object
Show child properties
id
Required string
Resource ID of the Attribute.
collection_id
Required string
Resource ID of the Collection.
name
Required string
Name of Attribute.
type
Required string
Attribute Type.
Show options
single-select multi-select
created_at
Required date
Date this Attribute was created.
options
Required array
List of Attribute Otions. Property only present in the *single-select* and **multi-select** attribute types.
Optional object
An Option of a Select-Multi-Select Attribute.
Show child properties
id
Required string
Resource ID of the Attribute Option.
attribute_id
Required string
Resource ID of the Attribute.
title
Required string
Title of the Attribute Option.
record
Required alternatives
The Record linked to this Entry.
Show child properties
Optional object
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
logo_url
Optional string
URL of the company logo.
description
Required string
Description of the Company.
domains
Required array
Domains used by the company. This is an ordered list, as the domains are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Company.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the company.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the company.
Show child properties
handle
Required string
Twitter handle of the company.
url
Required string
URL of the Twitter account of the company.
linkedin
Required object
Linked-In user information about the company.
Show child properties
handle
Required string
Linked-In handle of the company.
url
Required string
URL of the Linked-In account of the company.
facebook
Required object
Facebook user information about the company.
Show child properties
handle
Required string
Facebook handle of the company.
url
Required string
URL of the Facebook account of the company.
angellist
Required object
Angellist user information about the company.
Show child properties
handle
Required string
Angellist handle of the company.
url
Required string
URL of the Angellist account of the company.
instagram
Required object
Instagram user information about the company.
Show child properties
handle
Required string
Instagram handle of the company.
url
Required string
URL of the Instagram account of the company.
communication_intelligence
Required object
Communication information between your organization and the company.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the company.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the company and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the company.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the company.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this Record was created.
Optional object
Show child properties
id
Required string
Resource ID of the person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the person.
last_name
Required string
Last Name of the person.
avatar_url
Optional string
URL of the person avatar.
description
Required string
Description of the person.
email_addresses
Required array
Email addresses used by the person. This is an ordered list, as the email addresses are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Person.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the person.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the person.
Show child properties
handle
Required string
Twitter handle of the person.
url
Required string
URL of the Twitter account of the person.
linkedin
Required object
Linked-In user information about the person.
Show child properties
handle
Required string
Linked-In handle of the person.
url
Required string
URL of the Twitter account of the person.
facebook
Required object
Facebook user information about the person.
Show child properties
handle
Required string
Facebook handle of the person.
url
Required string
URL of the Twitter account of the person.
angellist
Required object
Angellist user information about the person.
Show child properties
handle
Required string
Angellist handle of the person.
url
Required string
URL of the Twitter account of the person.
instagram
Required object
Instagram user information about the person.
Show child properties
handle
Required string
Instagram handle of the person.
url
Required string
URL of the Twitter account of the person.
communication_intelligence
Required object
Twitter user information about the person.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the person.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the person and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the person.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the person.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this record was created.
created_at
Required date
Date this Entry was created.
attributes
Required object
The Attributes of the Entry.
Show child properties
Required alternatives
Attribute value.
Show child properties
Optional string
String value.
Optional number
String value
Optional boolean
Boolean value.
Optional date
Date value.
Optional object
An Option of a Select-Multi-Select Attribute.
Show child properties
id
Required string
Resource ID of the Attribute Option.
attribute_id
Required string
Resource ID of the Attribute.
title
Required string
Title of the Attribute Option.
Optional array
Optional object
An Option of a Select-Multi-Select Attribute.
Show child properties
id
Required string
Resource ID of the Attribute Option.
attribute_id
Required string
Resource ID of the Attribute.
title
Required string
Title of the Attribute Option.
Optional array
Optional alternatives
Show child properties
Optional object
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
logo_url
Optional string
URL of the company logo.
description
Required string
Description of the Company.
domains
Required array
Domains used by the company. This is an ordered list, as the domains are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Company.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the company.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the company.
Show child properties
handle
Required string
Twitter handle of the company.
url
Required string
URL of the Twitter account of the company.
linkedin
Required object
Linked-In user information about the company.
Show child properties
handle
Required string
Linked-In handle of the company.
url
Required string
URL of the Linked-In account of the company.
facebook
Required object
Facebook user information about the company.
Show child properties
handle
Required string
Facebook handle of the company.
url
Required string
URL of the Facebook account of the company.
angellist
Required object
Angellist user information about the company.
Show child properties
handle
Required string
Angellist handle of the company.
url
Required string
URL of the Angellist account of the company.
instagram
Required object
Instagram user information about the company.
Show child properties
handle
Required string
Instagram handle of the company.
url
Required string
URL of the Instagram account of the company.
communication_intelligence
Required object
Communication information between your organization and the company.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the company.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the company and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the company.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the company.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this Record was created.
Optional object
Show child properties
id
Required string
Resource ID of the person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the person.
last_name
Required string
Last Name of the person.
avatar_url
Optional string
URL of the person avatar.
description
Required string
Description of the person.
email_addresses
Required array
Email addresses used by the person. This is an ordered list, as the email addresses are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Person.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the person.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the person.
Show child properties
handle
Required string
Twitter handle of the person.
url
Required string
URL of the Twitter account of the person.
linkedin
Required object
Linked-In user information about the person.
Show child properties
handle
Required string
Linked-In handle of the person.
url
Required string
URL of the Twitter account of the person.
facebook
Required object
Facebook user information about the person.
Show child properties
handle
Required string
Facebook handle of the person.
url
Required string
URL of the Twitter account of the person.
angellist
Required object
Angellist user information about the person.
Show child properties
handle
Required string
Angellist handle of the person.
url
Required string
URL of the Twitter account of the person.
instagram
Required object
Instagram user information about the person.
Show child properties
handle
Required string
Instagram handle of the person.
url
Required string
URL of the Twitter account of the person.
communication_intelligence
Required object
Twitter user information about the person.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the person.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the person and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the person.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the person.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this record was created.
Optional array
Optional object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
Optional object
A Kanban Stage, part of a Kanban Attribute.
Show child properties
id
Required string
Resource ID of the Kanban Stage.
attribute_id
Required string
Resource ID of the Attribute.
name
Required string
Name of the Kanban Stage.
value_created_at
Required date
Date that this value was created.

Delete EntryBeta

Example Request

curl https://api.attio.com/v1/collections/7cd94aa9-1dba-4814-88b6-c9c514dd259f/entries/7cd94aa9-1dba-4814-88b6-c9c514dd259f \
    -X DELETE \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:\
    -H application/json \
    -d '{}'

Example Response (Status Code 200)

{}

Example Response (Status Code 404)

{}

Deletes an Entry from a Collection.

Required Scopes

Scope Required Level
Public Collections Read-Write
Private Collections Read-Write

HTTP Request

Request Path

DELETE https://api.attio.com/v1/collections/:collection_id/entries/:entry_id

URL Parameters

collection_id
Required string
Resource ID of the Collection.
entry_id
Required string
Resource ID of the Entry.

HTTP Response

Status Code - 200

Required object
The Entry was successfully deleted from the Collection

Status Code - 404

Required object
The Entry could not be found in the Collection.

Fetch EntryBeta

Example Request

curl https://api.attio.com/v1/collections/7cd94aa9-1dba-4814-88b6-c9c514dd259f/entries/7cd94aa9-1dba-4814-88b6-c9c514dd259f \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:

Example Response (Status Code 200)

{
    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
    "collection": {
        "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
        "name": "Fundraising",
        "is_public": true,
        "created_at": "2020-01-27T10:23:10.162Z",
        "members": [
            {
                "role": "read-only",
                "user": {
                    "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                    "first_name": "Elon",
                    "last_name": "Musk",
                    "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                    "email_address": "[email protected]",
                    "is_admin": true,
                    "is_suspended": false
                }
            }
        ],
        "attributes": [
            {
                "id": "d26d4f2e-b9a5-4587-8d11-bd0bd9383ac6",
                "collection_id": "b3dc767d-f861-47ad-acf1-046db449a8e0",
                "name": "Name of Attribute",
                "type": "text",
                "created_at": "2020-01-27T10:23:10.162Z"
            }
        ]
    },
    "record": {
        "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
        "contact_type": "company",
        "name": "Tesla",
        "logo_url": "https://tesla.com/tesla-logo.png",
        "description": "Tesla is an American electric vehicle company.",
        "domains": [
            "tesla.com"
        ],
        "entries": {
            "95c341dc-7c46-430c-809c-1dbdda9aaf99": [
                {
                    "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                    "collection_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99"
                }
            ]
        },
        "primary_location": {
            "city": "Palo Alto",
            "state": "California",
            "country_name": "United States of America",
            "country_code": "US"
        },
        "social_media": {
            "twitter": {
                "handle": "tesla",
                "url": "https://twitter.com/tesla"
            },
            "linkedin": {
                "handle": "tesla-motors",
                "url": "https://www.linkedin.com/company/tesla-motors"
            },
            "facebook": {
                "handle": "tesla",
                "url": "https://www.facebook.com/instagram"
            },
            "angellist": {
                "handle": "tesla",
                "url": "https://angel.co/company/uber"
            },
            "instagram": {
                "handle": "teslamotors",
                "url": "https://www.instagram.com/teslamotors/"
            }
        },
        "communication_intelligence": {
            "last_contacted_at": "2020-01-27T10:23:10.162Z",
            "last_contacted_by": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            },
            "strongest_connection_strength": "GOOD",
            "strongest_connection_user": {
                "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                "first_name": "Elon",
                "last_name": "Musk",
                "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                "email_address": "[email protected]",
                "is_admin": true,
                "is_suspended": false
            }
        },
        "roles": [
            {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "company_record": {
                    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                    "contact_type": "company",
                    "name": "Tesla"
                },
                "person_record": {
                    "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                    "contact_type": "person",
                    "first_name": "Elon",
                    "last_name": "Musk"
                },
                "title": "CEO",
                "started_at": "2020-01-27T10:23:10.162Z",
                "ended_at": "2020-01-27T10:23:10.162Z",
                "created_by": {
                    "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                    "first_name": "Elon",
                    "last_name": "Musk",
                    "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                    "email_address": "[email protected]",
                    "is_admin": true,
                    "is_suspended": false
                },
                "created_at": "2020-01-27T10:23:10.162Z"
            }
        ],
        "created_at": "2020-01-27T10:23:10.162Z"
    },
    "created_at": "2020-01-27T10:23:10.162Z",
    "attributes": {
        "e43067d7-48d6-450b-bb7e-a3affd2bda63": 227,
        "f2567717-6680-49c8-88c4-e084848119da": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
        "595e5b67-24b4-42a3-9817-070c447ae1ba": "2023-09-21T20:26:08.057Z",
        "95c341dc-7c46-430c-809c-1dbdda9aaf99": {
            "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
            "attribute_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99",
            "title": "Angel"
        },
        "801eb4ff-da66-4441-9b49-4483ffb4103e": [
            {
                "id": "eaf2290c-cf28-496a-97e5-e22c7cc25251",
                "attribute_id": "801eb4ff-da66-4441-9b49-4483ffb4103e",
                "title": "B"
            },
            {
                "id": "aeb0153e-45fe-486f-9cea-657e2b753b83",
                "attribute_id": "801eb4ff-da66-4441-9b49-4483ffb4103e",
                "title": "A"
            }
        ]
    }
}

Returns an entry in a collection.

Required Scopes

Scope Required Level
Public Collections Read
Private Collections Read

HTTP Request

Request Path

GET https://api.attio.com/v1/collections/:collection_id/entries/:entry_id

URL Parameters

collection_id
Required string
Resource ID of the Collection.
entry_id
Required string
Resource ID of the Entry.

HTTP Response

Status Code - 200

Required object
Show child properties
id
Required string
Resource ID of the Entry.
collection
Required object
Show child properties
id
Required string
Resource ID of the Collection.
name
Required string
Resource ID of the Collection.
is_public
Required boolean
Whether the Collection is public or private.
created_at
Required date
Date this Collection was created.
members
Required array
Optional object
Show child properties
role
Required string
Role of the Collection Member. On private collections, a read-write role is required to be able to modify the Collection.
Show options
read-only read-and-write full-access
user
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
attributes
Required array
List of Attributes for the Collection.
Optional alternatives
Show child properties
Optional object
Show child properties
id
Required string
Resource ID of the Attribute.
collection_id
Required string
Resource ID of the Collection.
name
Required string
Name of Attribute.
type
Required string
Attribute Type.
Show options
text number rating checkbox date currency multi-select-user record
created_at
Required date
Date this Attribute was created.
Optional object
Show child properties
id
Required string
Resource ID of the Attribute.
collection_id
Required string
Resource ID of the Collection.
name
Required string
Name of Attribute.
type
Required string
Attribute Type.
Show options
kanban-status
created_at
Required date
Date this Attribute was created.
kanban_stages
Required array
List of Kanban Stages. Property only present in the *kanban-status* attribute type.
Optional object
A Kanban Stage, part of a Kanban Attribute.
Show child properties
id
Required string
Resource ID of the Kanban Stage.
attribute_id
Required string
Resource ID of the Attribute.
name
Required string
Name of the Kanban Stage.
Optional object
Show child properties
id
Required string
Resource ID of the Attribute.
collection_id
Required string
Resource ID of the Collection.
name
Required string
Name of Attribute.
type
Required string
Attribute Type.
Show options
single-select multi-select
created_at
Required date
Date this Attribute was created.
options
Required array
List of Attribute Otions. Property only present in the *single-select* and **multi-select** attribute types.
Optional object
An Option of a Select-Multi-Select Attribute.
Show child properties
id
Required string
Resource ID of the Attribute Option.
attribute_id
Required string
Resource ID of the Attribute.
title
Required string
Title of the Attribute Option.
record
Required alternatives
The Record linked to this Entry.
Show child properties
Optional object
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
logo_url
Optional string
URL of the company logo.
description
Required string
Description of the Company.
domains
Required array
Domains used by the company. This is an ordered list, as the domains are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Company.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the company.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the company.
Show child properties
handle
Required string
Twitter handle of the company.
url
Required string
URL of the Twitter account of the company.
linkedin
Required object
Linked-In user information about the company.
Show child properties
handle
Required string
Linked-In handle of the company.
url
Required string
URL of the Linked-In account of the company.
facebook
Required object
Facebook user information about the company.
Show child properties
handle
Required string
Facebook handle of the company.
url
Required string
URL of the Facebook account of the company.
angellist
Required object
Angellist user information about the company.
Show child properties
handle
Required string
Angellist handle of the company.
url
Required string
URL of the Angellist account of the company.
instagram
Required object
Instagram user information about the company.
Show child properties
handle
Required string
Instagram handle of the company.
url
Required string
URL of the Instagram account of the company.
communication_intelligence
Required object
Communication information between your organization and the company.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the company.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the company and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the company.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the company.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this Record was created.
Optional object
Show child properties
id
Required string
Resource ID of the person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the person.
last_name
Required string
Last Name of the person.
avatar_url
Optional string
URL of the person avatar.
description
Required string
Description of the person.
email_addresses
Required array
Email addresses used by the person. This is an ordered list, as the email addresses are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Person.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the person.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the person.
Show child properties
handle
Required string
Twitter handle of the person.
url
Required string
URL of the Twitter account of the person.
linkedin
Required object
Linked-In user information about the person.
Show child properties
handle
Required string
Linked-In handle of the person.
url
Required string
URL of the Twitter account of the person.
facebook
Required object
Facebook user information about the person.
Show child properties
handle
Required string
Facebook handle of the person.
url
Required string
URL of the Twitter account of the person.
angellist
Required object
Angellist user information about the person.
Show child properties
handle
Required string
Angellist handle of the person.
url
Required string
URL of the Twitter account of the person.
instagram
Required object
Instagram user information about the person.
Show child properties
handle
Required string
Instagram handle of the person.
url
Required string
URL of the Twitter account of the person.
communication_intelligence
Required object
Twitter user information about the person.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the person.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the person and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the person.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the person.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this record was created.
created_at
Required date
Date this Entry was created.
attributes
Required object
The Attributes of the Entry.
Show child properties
Required alternatives
Attribute value.
Show child properties
Optional string
String value.
Optional number
String value
Optional boolean
Boolean value.
Optional date
Date value.
Optional object
An Option of a Select-Multi-Select Attribute.
Show child properties
id
Required string
Resource ID of the Attribute Option.
attribute_id
Required string
Resource ID of the Attribute.
title
Required string
Title of the Attribute Option.
Optional array
Optional object
An Option of a Select-Multi-Select Attribute.
Show child properties
id
Required string
Resource ID of the Attribute Option.
attribute_id
Required string
Resource ID of the Attribute.
title
Required string
Title of the Attribute Option.
Optional array
Optional alternatives
Show child properties
Optional object
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
logo_url
Optional string
URL of the company logo.
description
Required string
Description of the Company.
domains
Required array
Domains used by the company. This is an ordered list, as the domains are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Company.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the company.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the company.
Show child properties
handle
Required string
Twitter handle of the company.
url
Required string
URL of the Twitter account of the company.
linkedin
Required object
Linked-In user information about the company.
Show child properties
handle
Required string
Linked-In handle of the company.
url
Required string
URL of the Linked-In account of the company.
facebook
Required object
Facebook user information about the company.
Show child properties
handle
Required string
Facebook handle of the company.
url
Required string
URL of the Facebook account of the company.
angellist
Required object
Angellist user information about the company.
Show child properties
handle
Required string
Angellist handle of the company.
url
Required string
URL of the Angellist account of the company.
instagram
Required object
Instagram user information about the company.
Show child properties
handle
Required string
Instagram handle of the company.
url
Required string
URL of the Instagram account of the company.
communication_intelligence
Required object
Communication information between your organization and the company.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the company.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the company and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the company.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the company.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this Record was created.
Optional object
Show child properties
id
Required string
Resource ID of the person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the person.
last_name
Required string
Last Name of the person.
avatar_url
Optional string
URL of the person avatar.
description
Required string
Description of the person.
email_addresses
Required array
Email addresses used by the person. This is an ordered list, as the email addresses are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Person.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the person.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the person.
Show child properties
handle
Required string
Twitter handle of the person.
url
Required string
URL of the Twitter account of the person.
linkedin
Required object
Linked-In user information about the person.
Show child properties
handle
Required string
Linked-In handle of the person.
url
Required string
URL of the Twitter account of the person.
facebook
Required object
Facebook user information about the person.
Show child properties
handle
Required string
Facebook handle of the person.
url
Required string
URL of the Twitter account of the person.
angellist
Required object
Angellist user information about the person.
Show child properties
handle
Required string
Angellist handle of the person.
url
Required string
URL of the Twitter account of the person.
instagram
Required object
Instagram user information about the person.
Show child properties
handle
Required string
Instagram handle of the person.
url
Required string
URL of the Twitter account of the person.
communication_intelligence
Required object
Twitter user information about the person.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the person.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the person and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the person.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the person.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
person_record
Required object
Person performing this Role.
Show child properties
id
Required string
Resource ID of the Person.
contact_type
Required string
Contact Type.
Show options
person
first_name
Required string
First name of the Person.
last_name
Required string
Last Name of the Person.
title
Required string
Role title.
started_at
Required date
When the Person started performing this role.
ended_at
Required date
When the Person stopped performing this role.
created_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
created_at
Required date
Date this Role was created.
created_at
Required date
Date this record was created.
Optional array
Optional object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
Optional object
A Kanban Stage, part of a Kanban Attribute.
Show child properties
id
Required string
Resource ID of the Kanban Stage.
attribute_id
Required string
Resource ID of the Attribute.
name
Required string
Name of the Kanban Stage.
value_created_at
Required date
Date that this value was created.

List EntriesBeta

Example Request

curl https://api.attio.com/v1/collections/7cd94aa9-1dba-4814-88b6-c9c514dd259f/entries?offset=30&limit=10 \
    -u aa5c71134eb8e99f97e80785ef4d1dc22c6c5565c4d86a68ca7adf3867ab9447:

Example Response (Status Code 200)

{
    "next_page_offset": 25,
    "data": [
        {
            "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
            "collection": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "name": "Fundraising",
                "is_public": true,
                "created_at": "2020-01-27T10:23:10.162Z",
                "members": [
                    {
                        "role": "read-only",
                        "user": {
                            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                            "first_name": "Elon",
                            "last_name": "Musk",
                            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                            "email_address": "[email protected]",
                            "is_admin": true,
                            "is_suspended": false
                        }
                    }
                ],
                "attributes": [
                    {
                        "id": "d26d4f2e-b9a5-4587-8d11-bd0bd9383ac6",
                        "collection_id": "b3dc767d-f861-47ad-acf1-046db449a8e0",
                        "name": "Name of Attribute",
                        "type": "text",
                        "created_at": "2020-01-27T10:23:10.162Z"
                    }
                ]
            },
            "record": {
                "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                "contact_type": "company",
                "name": "Tesla",
                "logo_url": "https://tesla.com/tesla-logo.png",
                "description": "Tesla is an American electric vehicle company.",
                "domains": [
                    "tesla.com"
                ],
                "entries": {
                    "95c341dc-7c46-430c-809c-1dbdda9aaf99": [
                        {
                            "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                            "collection_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99"
                        }
                    ]
                },
                "primary_location": {
                    "city": "Palo Alto",
                    "state": "California",
                    "country_name": "United States of America",
                    "country_code": "US"
                },
                "social_media": {
                    "twitter": {
                        "handle": "tesla",
                        "url": "https://twitter.com/tesla"
                    },
                    "linkedin": {
                        "handle": "tesla-motors",
                        "url": "https://www.linkedin.com/company/tesla-motors"
                    },
                    "facebook": {
                        "handle": "tesla",
                        "url": "https://www.facebook.com/instagram"
                    },
                    "angellist": {
                        "handle": "tesla",
                        "url": "https://angel.co/company/uber"
                    },
                    "instagram": {
                        "handle": "teslamotors",
                        "url": "https://www.instagram.com/teslamotors/"
                    }
                },
                "communication_intelligence": {
                    "last_contacted_at": "2020-01-27T10:23:10.162Z",
                    "last_contacted_by": {
                        "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                        "first_name": "Elon",
                        "last_name": "Musk",
                        "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                        "email_address": "[email protected]",
                        "is_admin": true,
                        "is_suspended": false
                    },
                    "strongest_connection_strength": "GOOD",
                    "strongest_connection_user": {
                        "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                        "first_name": "Elon",
                        "last_name": "Musk",
                        "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                        "email_address": "[email protected]",
                        "is_admin": true,
                        "is_suspended": false
                    }
                },
                "roles": [
                    {
                        "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                        "company_record": {
                            "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                            "contact_type": "company",
                            "name": "Tesla"
                        },
                        "person_record": {
                            "id": "7cd94aa9-1dba-4814-88b6-c9c514dd259f",
                            "contact_type": "person",
                            "first_name": "Elon",
                            "last_name": "Musk"
                        },
                        "title": "CEO",
                        "started_at": "2020-01-27T10:23:10.162Z",
                        "ended_at": "2020-01-27T10:23:10.162Z",
                        "created_by": {
                            "id": "f839e0f6-700e-41c6-908f-f12aefac119c",
                            "first_name": "Elon",
                            "last_name": "Musk",
                            "avatar_url": "https://www.gravatar.com/avatar/63e3e6f3dbc0146f94e7df8369e6bc76?s=256",
                            "email_address": "[email protected]",
                            "is_admin": true,
                            "is_suspended": false
                        },
                        "created_at": "2020-01-27T10:23:10.162Z"
                    }
                ],
                "created_at": "2020-01-27T10:23:10.162Z"
            },
            "created_at": "2020-01-27T10:23:10.162Z",
            "attributes": {
                "e43067d7-48d6-450b-bb7e-a3affd2bda63": 227,
                "f2567717-6680-49c8-88c4-e084848119da": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
                "595e5b67-24b4-42a3-9817-070c447ae1ba": "2023-09-21T20:26:08.057Z",
                "95c341dc-7c46-430c-809c-1dbdda9aaf99": {
                    "id": "16b884fb-7864-4c4d-8ea4-63ace7b90cb6",
                    "attribute_id": "95c341dc-7c46-430c-809c-1dbdda9aaf99",
                    "title": "Angel"
                },
                "801eb4ff-da66-4441-9b49-4483ffb4103e": [
                    {
                        "id": "eaf2290c-cf28-496a-97e5-e22c7cc25251",
                        "attribute_id": "801eb4ff-da66-4441-9b49-4483ffb4103e",
                        "title": "B"
                    },
                    {
                        "id": "aeb0153e-45fe-486f-9cea-657e2b753b83",
                        "attribute_id": "801eb4ff-da66-4441-9b49-4483ffb4103e",
                        "title": "A"
                    }
                ]
            }
        }
    ]
}

Returns all of the Entries in a Collection ordered by their creation date.

Required Scopes

Scope Required Level
Public Collections Read
Private Collections Read

HTTP Request

Request Path

GET https://api.attio.com/v1/collections/:collection_id/entries

URL Parameters

collection_id
Required string
Resource ID of the Collection.

Query Parameters

offset
Optional number
An offset used for pagination. This represents the number of Entries that will be skipped from the beginning of the list.
limit
Optional number
The number of results to include in the response. The limit can range between 1 and 500, and the default is 10.

HTTP Response

Status Code - 200

Optional object
Show child properties
next_page_offset
Required number
An offset used for pagination. This value can be provided to the endpoint to fetch the subsequent page of results. If the value is not provided then this is the last page of results.
data
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection
Required object
Show child properties
id
Required string
Resource ID of the Collection.
name
Required string
Resource ID of the Collection.
is_public
Required boolean
Whether the Collection is public or private.
created_at
Required date
Date this Collection was created.
members
Required array
Optional object
Show child properties
role
Required string
Role of the Collection Member. On private collections, a read-write role is required to be able to modify the Collection.
Show options
read-only read-and-write full-access
user
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
attributes
Required array
List of Attributes for the Collection.
Optional alternatives
Show child properties
Optional object
Show child properties
id
Required string
Resource ID of the Attribute.
collection_id
Required string
Resource ID of the Collection.
name
Required string
Name of Attribute.
type
Required string
Attribute Type.
Show options
text number rating checkbox date currency multi-select-user record
created_at
Required date
Date this Attribute was created.
Optional object
Show child properties
id
Required string
Resource ID of the Attribute.
collection_id
Required string
Resource ID of the Collection.
name
Required string
Name of Attribute.
type
Required string
Attribute Type.
Show options
kanban-status
created_at
Required date
Date this Attribute was created.
kanban_stages
Required array
List of Kanban Stages. Property only present in the *kanban-status* attribute type.
Optional object
A Kanban Stage, part of a Kanban Attribute.
Show child properties
id
Required string
Resource ID of the Kanban Stage.
attribute_id
Required string
Resource ID of the Attribute.
name
Required string
Name of the Kanban Stage.
Optional object
Show child properties
id
Required string
Resource ID of the Attribute.
collection_id
Required string
Resource ID of the Collection.
name
Required string
Name of Attribute.
type
Required string
Attribute Type.
Show options
single-select multi-select
created_at
Required date
Date this Attribute was created.
options
Required array
List of Attribute Otions. Property only present in the *single-select* and **multi-select** attribute types.
Optional object
An Option of a Select-Multi-Select Attribute.
Show child properties
id
Required string
Resource ID of the Attribute Option.
attribute_id
Required string
Resource ID of the Attribute.
title
Required string
Title of the Attribute Option.
record
Required alternatives
The Record linked to this Entry.
Show child properties
Optional object
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.
logo_url
Optional string
URL of the company logo.
description
Required string
Description of the Company.
domains
Required array
Domains used by the company. This is an ordered list, as the domains are used for data enrichment.
Optional string
entries
Required object
Entries linked to this Company.
Show child properties
Required array
Optional object
Show child properties
id
Required string
Resource ID of the Entry.
collection_id
Required string
Resource ID of the Entry's Collection.
primary_location
Required object
Address of the primary location of the company.
Show child properties
city
Required string
City.
state
Required string
State.
country_name
Required string
Country.
country_code
Required string
ISO 3166-1 alpha-2 country code.
social_media
Optional object
Show child properties
twitter
Required object
Twitter user information about the company.
Show child properties
handle
Required string
Twitter handle of the company.
url
Required string
URL of the Twitter account of the company.
linkedin
Required object
Linked-In user information about the company.
Show child properties
handle
Required string
Linked-In handle of the company.
url
Required string
URL of the Linked-In account of the company.
facebook
Required object
Facebook user information about the company.
Show child properties
handle
Required string
Facebook handle of the company.
url
Required string
URL of the Facebook account of the company.
angellist
Required object
Angellist user information about the company.
Show child properties
handle
Required string
Angellist handle of the company.
url
Required string
URL of the Angellist account of the company.
instagram
Required object
Instagram user information about the company.
Show child properties
handle
Required string
Instagram handle of the company.
url
Required string
URL of the Instagram account of the company.
communication_intelligence
Required object
Communication information between your organization and the company.
Show child properties
last_contacted_at
Required date
Last time there was an email between your organisation and the company.
last_contacted_by
Required object
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
strongest_connection_strength
Required string
Connection Strength between the company and your organization.
Show options
VERY_STRONG STRONG GOOD WEAK VERY_WEAK NONE null
strongest_connection_user
Required object
Best connected user to the company.
Show child properties
id
Required string
Resource ID of this user.
first_name
Required string
First name of this user.
last_name
Required string
Last name of this user.
avatar_url
Required string
URL to the avatar image of this user.
email_address
Required string
Email address of this user.
is_admin
Required boolean
Whether this user is an administrator.
is_suspended
Required boolean
Whether the user is suspended.
roles
Required array
Roles related to the company.
Optional object
Show child properties
id
Required string
Resource ID of this Role.
company_record
Required object
Company linked to this Role.
Show child properties
id
Required string
Resource ID of this Company.
contact_type
Required string
Contact Type.
Show options
company
name
Required string
Name of the Company.