REST API - Attio Docs

The workspace blocklist hides the emails and calendar events of chosen email addresses or domains across your workspace. You can add or update and delete addresses. These endpoints use the new email_calendar_blocklist scope and are in alpha.

The avatar_url attribute on people and the logo_url attribute on companies can now be written through the API. Set them when you create, upsert or update (append or overwrite) a record.

Create call recording now requires the transcript field. Requests without a transcript return a 400 validation error.

OAuth access tokens can now be user-level. A user-level token acts for one workspace member. It can only use the data and permissions that the member has. To get a user-level token, set token_level=user on the authorize URL and send a PKCE code_challenge. Any workspace member can grant a user-level token. Your app must request user scopes, and a workspace admin must approve them.
Introspect returns a token_level field. This field shows the level of the token.
The reference documentation for each endpoint shows the token levels that the endpoint supports. Some endpoints only accept workspace-level tokens, for example the webhook endpoints.

Activities model things that happen over time, such as phone calls or site visits. You can list, create, get, update and delete activities, and the attribute endpoints now accept activities as a target. These endpoints use the new activity_configuration scope and are in beta.
Activity records are the individual entries of an activity, such as one specific phone call. You can list, create, upsert, get, update (append or overwrite) and delete activity records. These endpoints use the new activity_record scope and are in beta.
Seven new webhook events for activities: activity.created, activity.updated, activity.deleted, activity-attribute.created, activity-attribute.updated, activity-record.created and activity-record.deleted.
Record reference attributes accept a new target_record_reference write format. It lets you choose what happens when no record or more than one record matches, and can create the referenced record as part of the same request. See linking referenced records for details. Every referenced record created this way counts as one more request against the write rate limit.

See the activities guide to get started.

Update a meeting (append linked records) and update a meeting (overwrite linked records) link records to a meeting. Appending adds to the meeting’s existing linked records; overwriting replaces them, unlinking any record not included in the request. Both endpoints are in beta.

Delete a meeting deletes a single meeting. Meetings created by calendar sync cannot be deleted through the API; delete the event in the source calendar instead. This endpoint is in beta.

Revoke revokes an access token, so that it can no longer be used to make requests to the Attio REST API.

Delete an object deletes a custom object and all of its records. System objects, such as people and companies, cannot be deleted.

This endpoint is destructive and cannot be undone. Use it with caution, as it has the potential to remove a large amount of valuable data.

List notes is now rate limited to 10 requests per second, down from the default 100 requests per second for reads. This is a temporary measure to protect platform stability, and we will announce here when the limit is raised again.

List threads now returns at most 80 replies per thread, oldest first. Each thread gets a new has_more_comments field to indicate if there are more comments to fetch.
Get a thread and its comments (formerly “Get a thread”) is now paginated: at most 250 comments are returned per request. Use the new cursor and limit query parameters to page through a thread’s comments, and created_after to return only comments created after a timestamp, useful for polling a thread for new replies. The response now includes a pagination.next_cursor field.

Update a note changes an existing note’s title and/or content. Only the fields you provide are changed; a note’s parent record cannot be changed.

Add emails to the unsubscribe list allows you to add email addresses to the global sequences unsubscribe list. This endpoint is in beta.

Write record attribute values and write list entry attribute values replace the full value history of one attribute, for migration of historical data from other systems. Webhooks and workflow triggers do not fire for these writes. Both endpoints are in beta.
Merge two records combines two records of the same object into one new record. The values of the primary record have precedence. This endpoint is in beta.
List emails gives the metadata of emails from the connected mailboxes in your workspace. Email content is never returned. This endpoint is in alpha.