> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/attio.md).

# Attio

Connect Attio CRM objects, records, notes, tasks, and workspace members.

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector | Authentication |
| --------- | -------------- |
| Attio     | API Key        |

#### Attio

Connect one Attio workspace with a scoped API key.

**Set up in Attio**

1. Prepare the Attio account or service that the workflow will access. Grant access to the required resources and operations.
2. **API Key:** Create a scoped API key in Attio workspace settings. It is limited to one workspace and can be revoked or have its scopes changed in Attio.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Attio**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                                                                                                                                                                                                      |
| ------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Key       | Yes      | Create a scoped API key in Attio workspace settings. It is limited to one workspace and can be revoked or have its scopes changed in Attio. [Provider instructions](https://attio.com/help/apps/other-apps/generating-an-api-key). |

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Use an action

1. Add the required **Attio** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

#### List Objects

List the standard and custom objects in your Attio workspace.

**Required permissions:** `object_configuration:read`.

**Inputs**

No input fields are required in this catalog entry.

**Outputs**

| Field   | Type          | Description                                                   |
| ------- | ------------- | ------------------------------------------------------------- |
| Objects | object\_array | Standard and custom objects available in the Attio workspace. |

#### List Object Attributes

List the fields that can be read or written on an Attio object.

**Required permissions:** `object_configuration:read`.

**Inputs**

| Field                       | Type            | Required | Description                                                                                    |
| --------------------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------- |
| Object                      | select (string) | Yes      | The Attio object whose fields you want to inspect. Options load from the selected connection.  |
| Include Archived Attributes | boolean         | No       | Include fields that have been archived in Attio. Default: false.                               |
| Maximum Attributes          | integer         | No       | The most attribute definitions to return in this call. Minimum: 1. Maximum: 200. Default: 100. |
| Starting Offset             | integer         | No       | The number of attributes to skip before returning results. Minimum: 0. Default: 0.             |

**Outputs**

| Field       | Type          | Description                                                                 |
| ----------- | ------------- | --------------------------------------------------------------------------- |
| Attributes  | object\_array | The fields configured on the selected Attio object.                         |
| Next Offset | integer       | The offset to use for the next page, or empty when the listing is complete. |

#### Create Record

Create a new record in a standard or custom Attio object.

**Required permissions:** `object_configuration:read`, `record_permission:read-write`.

**Inputs**

| Field            | Type            | Required | Description                                                                                   |
| ---------------- | --------------- | -------- | --------------------------------------------------------------------------------------------- |
| Object           | select (string) | Yes      | The Attio object that will contain the new record. Options load from the selected connection. |
| Attribute Values | textarea        | Yes      | The new record's field values as a JSON object keyed by Attio attribute slug or UUID.         |

**Outputs**

| Field  | Type   | Description                     |
| ------ | ------ | ------------------------------- |
| Record | object | The newly created Attio record. |

#### Update Record

Update selected fields on an existing Attio record, replacing supplied multiselect values.

**Required permissions:** `object_configuration:read`, `record_permission:read-write`.

**Inputs**

| Field            | Type            | Required | Description                                                                           |
| ---------------- | --------------- | -------- | ------------------------------------------------------------------------------------- |
| Object           | select (string) | Yes      | The Attio object that contains the record. Options load from the selected connection. |
| Record           | select (string) | Yes      | The existing Attio record to update. Options load from the selected connection.       |
| Attribute Values | textarea        | Yes      | The fields to update as JSON keyed by Attio attribute slug or UUID.                   |

**Outputs**

| Field  | Type   | Description                                                   |
| ------ | ------ | ------------------------------------------------------------- |
| Record | object | The record after Attio applied the supplied attribute values. |

#### List Records

List records from a standard or custom Attio object.

**Required permissions:** `object_configuration:read`, `record_permission:read`.

**Inputs**

| Field             | Type            | Required | Description                                                                                                          |
| ----------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
| Object            | select (string) | Yes      | The Attio object whose records you want to list. Options load from the selected connection.                          |
| Attribute Filter  | textarea        | No       | Optional Attio attribute conditions that narrow the records returned.                                                |
| Saved View Filter | select (string) | No       | Use an Attio saved view's filter configuration. Options load from the selected connection.                           |
| Sort Attribute    | select (string) | No       | The object field used to order the records. Options load from the selected connection.                               |
| Sort Direction    | select (string) | No       | Sort the selected attribute in ascending or descending order. Available values: Ascending, Descending. Default: asc. |
| Nested Sort Field | string          | No       | An optional subfield for compound values such as a person's last name.                                               |
| Maximum Records   | integer         | No       | The most records to return in this call. Minimum: 1. Maximum: 500. Default: 100.                                     |
| Starting Offset   | integer         | No       | The number of records to skip before returning results. Minimum: 0. Default: 0.                                      |

**Outputs**

| Field       | Type          | Description                                                                 |
| ----------- | ------------- | --------------------------------------------------------------------------- |
| Records     | object\_array | Records returned from the selected Attio object.                            |
| Next Offset | integer       | The offset to use for the next page, or empty when the listing is complete. |

#### Create Note

Add a plaintext or Markdown note to an Attio record.

**Required permissions:** `note:read-write`, `object_configuration:read`, `record_permission:read`.

**Inputs**

| Field          | Type            | Required | Description                                                                                                                     |
| -------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Parent Object  | select (string) | Yes      | The Attio object that contains the record for this note. Options load from the selected connection.                             |
| Parent Record  | select (string) | Yes      | The Attio record that will contain the note. Options load from the selected connection.                                         |
| Title          | string          | Yes      | A short plaintext title for the note.                                                                                           |
| Content        | textarea        | Yes      | The body of the note.                                                                                                           |
| Content Format | select (string) | No       | Whether the note body uses plain text or Attio's supported Markdown. Available values: Plain Text, Markdown. Default: markdown. |

**Outputs**

| Field | Type   | Description                   |
| ----- | ------ | ----------------------------- |
| Note  | object | The newly created Attio note. |

#### List Workspace Members

List the people who can be assigned Attio tasks in the connected workspace.

**Required permissions:** `user_management:read`.

**Inputs**

No input fields are required in this catalog entry.

**Outputs**

| Field             | Type          | Description                                                        |
| ----------------- | ------------- | ------------------------------------------------------------------ |
| Workspace Members | object\_array | People who can be assigned tasks in the connected Attio workspace. |

#### Create Task

Create an Attio task with an optional deadline, linked record, and assignee.

**Required permissions:** `task:read-write`, `object_configuration:read`, `record_permission:read`, `user_management:read`.

**Inputs**

| Field                | Type            | Required | Description                                                                                     |
| -------------------- | --------------- | -------- | ----------------------------------------------------------------------------------------------- |
| Task                 | textarea        | Yes      | The plaintext task instructions.                                                                |
| Deadline             | datetime        | No       | An optional date and time when the task is due.                                                 |
| Completed            | boolean         | No       | Create the task already marked complete. Default: false.                                        |
| Linked Record Object | select (string) | No       | The object containing the record this task is about. Options load from the selected connection. |
| Linked Record        | select (string) | No       | The Attio record this task is about. Options load from the selected connection.                 |
| Assignee Email       | select (string) | No       | The Attio workspace member who should own the task. Options load from the selected connection.  |

**Outputs**

| Field | Type   | Description                   |
| ----- | ------ | ----------------------------- |
| Task  | object | The newly created Attio task. |

### Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/attio.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
