# Attio

Your Toolhouse AI Worker can connect to Attio using 108 specialized tools.

## Auth Connection

This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=attio).

## Tools (108)

### `Attio Assert Company`

Integration name: **ATTIO\_ASSERT\_COMPANY**

Creates or updates a company record in Attio using a unique attribute to search for existing companies. If a company is found with the same value for the matching attribute, that company will be updated. If no company is found, a new one will be created. Use this when you prefer to update records on conflicts.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type   | Required | Example                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------- | ------ | :------: | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`               | string |          | `"Acme Corporation"`                                  | The name of the company. Optional but recommended.                                                                                                                                                                                                                                                                                                                                                                                     |
| `team`               | array  |          | `["john@example.com","jane@example.com"]`             | List of team member email addresses to associate with this company. These should be email addresses of people records in your workspace.                                                                                                                                                                                                                                                                                               |
| `domain`             | string |          | `"example.com"`                                       | Single website domain for the company (automatically converted to list format). Use this for convenience when providing a single domain. Alternatively, use 'domains' to provide multiple domains at once.                                                                                                                                                                                                                             |
| `domains`            | array  |          | `["example.com"]`                                     | List of website domains for the company. If matching\_attribute is 'domains', either 'domain' or 'domains' is typically required. For multiselect attributes like domains, new values will be added and existing values will not be deleted. Provide as simple strings (e.g., \['example.com', 'example.org']).                                                                                                                        |
| `description`        | string |          | `"Leading provider of enterprise software solutions"` | Description or summary of the company                                                                                                                                                                                                                                                                                                                                                                                                  |
| `primary_location`   | string |          | `"1 Infinite Loop, Cupertino, CA, 95014, US"`         | Physical business address of the company. Use string format: '1 Infinite Loop, Cupertino, CA, 95014, US' (recommended). Alternatively, you can provide an object with all 10 location fields.                                                                                                                                                                                                                                          |
| `matching_attribute` | string |     ✅    | `"domains"`                                           | The ID or slug of the attribute used to check if a company already exists. Must be an attribute with a uniqueness constraint. If a company is found with the same value for this attribute, it will be updated. If no company is found, a new one will be created. Common examples: 'domains' (most common) or any custom unique attribute slug. WARNING: 'name' is NOT a unique attribute and cannot be used as a matching attribute. |

***

### `Attio Assert Person`

Integration name: **ATTIO\_ASSERT\_PERSON**

Tool to create or update person records using a unique attribute to search for existing people. Use when you want to ensure a person exists with specific details without creating duplicates.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type   | Required | Example                                                                                                                                                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------- | ------ | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `values`             | object |     ✅    | `{"name":[{"full_name":"John Doe","last_name":"Doe","first_name":"John"}],"job_title":"Software Engineer","description":"Developer met at conference","email_addresses":[{"email_address":"john.doe@example.com"}]}` | Dictionary of attribute slugs to values. **CRITICAL**: The matching attribute specified in 'matching\_attribute' MUST be included in the values. **ATTRIBUTE FORMATS**: (1) 'email\_addresses': Use \[{'email\_address': '<john@example.com>'}] or \['<john@example.com>']. (2) 'name': Use \[{'first\_name': 'John', 'last\_name': 'Doe', 'full\_name': 'John Doe'}] or \[{'full\_name': 'John Doe'}]. Both first\_name and last\_name are required by the API (default to empty string if not provided). (3) 'phone\_numbers': Use \[{'original\_phone\_number': '+15558675309', 'country\_code': 'US'}]. (4) 'primary\_location': Use string format like '1 Infinite Loop, Cupertino, CA, 95014, US'. (5) 'company': Use \[{'target\_object': 'companies', 'target\_record\_id': '\<company\_uuid>'}] for record reference. (6) 'linkedin': Use simple string URL. **MULTISELECT BEHAVIOR**: If the matching attribute is a multiselect, new values are added (existing kept). For other multiselect attributes, values are synced to match the supplied list. |
| `matching_attribute` | string |     ✅    | `"email_addresses"`                                                                                                                                                                                                  | The ID or slug of the unique attribute to check if a person already exists. For person records, email\_addresses is the only unique attribute by default. If a person is found with the same value for this attribute, that person will be updated. If no person with the same value is found, a new person will be created instead.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

***

### `Attio Assert User Record`

Integration name: **ATTIO\_ASSERT\_USER\_RECORD**

Creates or updates a user record in Attio using a unique attribute to search for existing users. If a user is found with the same value for the matching attribute, that user will be updated. If no user is found, a new one will be created. Use this to ensure user records exist without duplicates.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type   | Required | Example                                                                                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------- | ------ | :------: | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `values`             | object |     ✅    | `{"user_id":[{"value":"user_123"}],"primary_email_address":[{"email_address":"john.doe@example.com"}]}` | The attribute values for the user record as a dictionary where keys are attribute slugs and values are the attribute data. **CRITICAL - MATCHING ATTRIBUTE BEHAVIOR**: The matching attribute specified in the 'matching\_attribute' parameter MUST be included in the values. **ATTRIBUTE FORMATS**: (1) 'primary\_email\_address': Use \[{'email\_address': '<user@example.com>'}] or \['<user@example.com>'] format. (2) 'user\_id': Use \[{'value': 'user\_123'}] or simple string value. (3) 'person': Use \[{'target\_object': 'people', 'target\_record\_id': '\<person\_uuid>'}] for record reference. (4) 'workspace': Use \[{'target\_object': 'workspaces', 'target\_record\_id': '\<workspace\_uuid>'}] for record reference. **MULTISELECT BEHAVIOR**: If the matching attribute is a multiselect attribute, new values will be added and existing values will not be deleted. For any other multiselect attribute, all values will be either created or deleted as necessary to match the list of supplied values. |
| `matching_attribute` | string |     ✅    | `"primary_email_address"`                                                                               | The ID or slug of the unique attribute to check if a user record already exists. Must be a unique attribute. If a user is found with the same value for this attribute, it will be updated. If no user is found, a new one will be created. Common examples: 'primary\_email\_address', 'user\_id', or any custom unique attribute slug.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

***

### `Attio Assert Workspace`

Integration name: **ATTIO\_ASSERT\_WORKSPACE**

Creates or updates a workspace record in Attio using a unique attribute to search for existing workspaces. If a workspace is found with the same value for the matching attribute, that workspace will be updated. If no workspace is found, a new one will be created.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type   | Required | Example                            | Description                                                                                                                                                                                                                                                                                                                                    |
| -------------------- | ------ | :------: | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`               | string |          | `"Production Workspace"`           | The name of the workspace.                                                                                                                                                                                                                                                                                                                     |
| `users`              | array  |          | `["user-uuid-1","user-uuid-2"]`    | List of user record IDs to associate with this workspace. These should be UUIDs of user records in your Attio workspace. Format: provide as list of record IDs which will be converted to record references.                                                                                                                                   |
| `company`            | string |          | `"company-uuid-123"`               | Company record ID to associate with this workspace. This should be the UUID of a company record in your Attio workspace. Will be converted to a record reference.                                                                                                                                                                              |
| `avatar_url`         | string |          | `"https://example.com/avatar.png"` | URL to the workspace's avatar image.                                                                                                                                                                                                                                                                                                           |
| `workspace_id`       | string |          | `"workspace-123"`                  | The unique identifier for the workspace. Use this when matching\_attribute is 'workspace\_id'.                                                                                                                                                                                                                                                 |
| `matching_attribute` | string |     ✅    | `"workspace_id"`                   | The ID or slug of the attribute used to check if a workspace already exists. Must be a unique attribute. If a workspace is found with the same value for this attribute, it will be updated. If no workspace is found, a new one will be created. Common examples: 'workspace\_id' (most common), 'name', or any custom unique attribute slug. |

***

### `Attio Create Attribute`

Integration name: **ATTIO\_CREATE\_ATTRIBUTE**

Tool to create a new attribute on an object or list in Attio. Use when you need to add custom fields to track additional information. For record-reference types, you can establish bidirectional relationships by supplying a relationship object.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example          | Description                                                                                                                                                                                                                               |
| ---------------- | ------- | :------: | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`           | string  |     ✅    | `"text"`         | Attribute type: text, number, checkbox, currency, date, timestamp, rating, status, select, record-reference, actor-reference, location, domain, email-address, phone-number, interaction, personal-name                                   |
| `title`          | string  |     ✅    | `"Custom Field"` | Display name for the attribute                                                                                                                                                                                                            |
| `config`         | object  |     ✅    | —                | Type-specific configuration settings (required for currency and record-reference types)                                                                                                                                                   |
| `target`         | string  |     ✅    | `"objects"`      | Whether the attribute is on an object or list.                                                                                                                                                                                            |
| `api_slug`       | string  |     ✅    | `"custom_field"` | Snake-case identifier for API calls (e.g., 'custom\_field')                                                                                                                                                                               |
| `is_unique`      | boolean |          | —                | Whether values must be distinct across records. Uniqueness restrictions apply only to new data, not retroactively. Some attribute types (e.g., 'select') do not support unique constraints; the API will return an error if incompatible. |
| `identifier`     | string  |     ✅    | `"people"`       | A UUID or slug identifying the object or list to create the attribute on                                                                                                                                                                  |
| `description`    | string  |          | —                | Explanatory text about the attribute                                                                                                                                                                                                      |
| `is_required`    | boolean |          | —                | Whether new records must have a value for this attribute. Note: Required attributes (is\_required=true) are not permitted on lists; only custom objects support required attributes.                                                      |
| `relationship`   | object  |          | —                | Bidirectional relationship configuration for record-reference attributes                                                                                                                                                                  |
| `default_value`  | object  |          | —                | Initial value assignment strategy                                                                                                                                                                                                         |
| `is_multiselect` | boolean |          | —                | Whether the attribute permits multiple values                                                                                                                                                                                             |

***

### `Attio Create Comment`

Integration name: **ATTIO\_CREATE\_COMMENT**

Tool to create a new comment on a thread, record, or list entry in Attio. Use when you need to add a comment to an existing conversation, a record (like a person, company, or deal), or a list entry.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                                                                                                                                        |
| ----------- | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `entry`     | object |          | —                                        | Reference to a list entry to attach the comment to.                                                                                                                |
| `author`    | object |     ✅    | —                                        | The workspace member who wrote this comment. Must include type='workspace-member' and the UUID of the workspace member.                                            |
| `format`    | string |          | —                                        | Format of the comment content. Currently only 'plaintext' is supported. Uses line feed character \n for new lines.                                                 |
| `record`    | object |          | —                                        | Reference to a record to attach the comment to.                                                                                                                    |
| `content`   | string |     ✅    | `"This is a test comment."`              | The plaintext content of the comment. Use \n for line breaks.                                                                                                      |
| `thread_id` | string |          | `"aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2"` | UUID of an existing thread to add the comment to. Mutually exclusive with 'record' and 'entry'. Use this when adding a comment to an existing conversation thread. |

***

### `Attio Create Company`

Integration name: **ATTIO\_CREATE\_COMPANY**

Creates a new company record in Attio. This endpoint will throw an error on conflicts of unique attributes like domains. If you prefer to update company records on conflicts, use the Assert company record endpoint instead. Note: The logo\_url attribute cannot currently be set via the API.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                                               | Description                                                                                                                                                                                                                                                                                                                                  |
| ------------------ | ------ | :------: | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`             | string |          | `"Acme Corporation"`                                  | The name of the company. Optional but recommended.                                                                                                                                                                                                                                                                                           |
| `team`             | array  |          | `["john@example.com","jane@example.com"]`             | List of team member email addresses to associate with this company. These should be email addresses of people records in your workspace.                                                                                                                                                                                                     |
| `domains`          | array  |          | `["example.com"]`                                     | List of website domains for the company. This field has a uniqueness constraint - the endpoint will throw an error if any domain conflicts with an existing company record. If you prefer to update records on conflicts instead, use the Assert company record endpoint. Provide as simple strings (e.g., \['example.com', 'example.org']). |
| `description`      | string |          | `"Leading provider of enterprise software solutions"` | Description or summary of the company                                                                                                                                                                                                                                                                                                        |
| `primary_location` | —      |          | `"1 Infinite Loop, Cupertino, CA, 95014, US"`         | Physical business address of the company. Use string format: '1 Infinite Loop, Cupertino, CA, 95014, US' (recommended). Alternatively, you can provide an object with all 10 location fields.                                                                                                                                                |

***

### `Attio Create Deal Record`

Integration name: **ATTIO\_CREATE\_DEAL\_RECORD**

Tool to create a new deal record in Attio. Use when you need to track a new sales opportunity or deal. This endpoint will throw an error on conflicts of unique attributes. Minimal requirement is providing at least one attribute value.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                   | Type   | Required | Example                                    | Description                                                                                                                |
| --------------------------- | ------ | :------: | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| `name`                      | string |          | `"Contract with Fundstack"`                | The name of the deal. Optional but recommended.                                                                            |
| `stage`                     | string |          | `"Lead"`                                   | The status/stage of the deal. Can be the status UUID or status title (e.g., 'Lead', 'In Progress', 'Won', 'Lost').         |
| `value`                     | number |          | `99.99`                                    | The monetary value of the deal. Decimal number with max 4 decimal places.                                                  |
| `owner_id`                  | string |          | `"92446133-64cf-4f83-bca9-594ca2f8da57"`   | UUID of the workspace member who owns this deal. Use owner\_email instead if you have the email address.                   |
| `owner_email`               | string |          | `"alice@attio.com"`                        | Email address of the workspace member who owns this deal. This is the preferred way to set the owner.                      |
| `associated_company_id`     | string |          | `"92446133-64cf-4f83-bca9-594ca2f8da57"`   | Company record UUID to associate with this deal. Use this if you have the company record ID.                               |
| `associated_people_ids`     | array  |          | `["92446133-64cf-4f83-bca9-594ca2f8da57"]` | List of person record UUIDs to associate with this deal. Use this if you have the person record IDs.                       |
| `associated_people_emails`  | array  |          | `["john@example.com","jane@example.com"]`  | List of email addresses to associate people with this deal. The system will find matching person records by email address. |
| `associated_company_domain` | string |          | `"example.com"`                            | Domain name to associate a company with this deal. The system will find the matching company record by domain.             |

***

### `Attio Create Entry`

Integration name: **ATTIO\_CREATE\_ENTRY**

DEPRECATED: Use ATTIO\_ATTIO\_POST\_V2\_LISTS\_LIST\_ENTRIES instead. Tool to add a record to a list as a new list entry in Attio. Use when you need to organize records into specific lists. Throws errors on unique attribute conflicts. Multiple list entries are allowed for the same parent record.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                                  | Description                                                                                                                                          |
| ------------------ | ------ | :------: | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_id`          | string |     ✅    | `"enterprise_sales"`                     | A UUID or slug identifying the list to add the entry to                                                                                              |
| `entry_values`     | object |          | —                                        | Custom attribute values for the list entry. Field values organized by attribute slug or ID. For multiselect attributes, all values must be specified |
| `parent_object`    | string |     ✅    | `"people"`                               | The UUID or slug of the parent object type (e.g., 'people', 'companies')                                                                             |
| `parent_record_id` | string |     ✅    | `"bf071e1f-6035-429d-b874-d83ea64ea13b"` | The UUID of the record being added to the list                                                                                                       |

***

### `Attio Create List`

Integration name: **ATTIO\_CREATE\_LIST**

Tool to create a new list in Attio. Use when you need to organize records into custom lists. Once created, add attributes using the Create Attribute API and add records using the Create Entry API. New lists must have either workspace\_access set to 'full-access' or one or more workspace\_member\_access with 'full-access' level.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                                                                  | Description                                                                                                                                                                                                                                                                                                  |
| ------------------------- | ------ | :------: | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `name`                    | string |     ✅    | `"Enterprise Sales"`                                                                     | The human-readable name of the list                                                                                                                                                                                                                                                                          |
| `api_slug`                | string |     ✅    | `"enterprise_sales"`                                                                     | A unique, human-readable slug to access the list through API calls. Should be formatted in snake case                                                                                                                                                                                                        |
| `parent_object`           | string |     ✅    | `"people"`                                                                               | A UUID or slug to identify the allowed object type for records added to this list (e.g., 'people', 'companies')                                                                                                                                                                                              |
| `workspace_access`        | —      |     ✅    | `"read-and-write"`                                                                       | The level of access granted to all members of the workspace for this list. Pass null to keep the list private and only grant access to specific workspace members. Note: New lists must have either workspace\_access set to 'full-access' or one or more workspace\_member\_access with 'full-access' level |
| `workspace_member_access` | array  |     ✅    | `[{"level":"full-access","workspace_member_id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}]` | The level of access granted to specific workspace members for this list. Pass an empty array to grant access to no workspace members. Note: New lists must have either workspace\_access set to 'full-access' or one or more workspace\_member\_access with 'full-access' level                              |

***

### `Attio Create Note`

Integration name: **ATTIO\_CREATE\_NOTE**

This tool creates a new note on a given record in Attio. The note can be attached to any record type (like person, company, or deal) and includes a title and content. It requires parameters such as parent\_object, parent\_record\_id, title, and content, with an optional created\_at timestamp.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------ | ------ | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `title`            | string |     ✅    | `"Meeting Notes"`                             | The title of the note                                                                                                                                                                                                                                                                                                                                                                                         |
| `content`          | string |     ✅    | `"Discussed project timeline and next steps"` | The content of the note                                                                                                                                                                                                                                                                                                                                                                                       |
| `created_at`       | string |          | `"2023-12-25T10:30:00Z"`                      | Optional timestamp for when the note was created (ISO 8601 format)                                                                                                                                                                                                                                                                                                                                            |
| `parent_object`    | string |     ✅    | `"people"`                                    | The object type the note is associated with. Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'.                                                                                                                                                                                                                                                                             |
| `parent_record_id` | string |     ✅    | `"f3b2962b-febb-4e01-8431-f7ffb4d87e5e"`      | **MUST BE A VALID UUID** - The unique identifier of the specific record within the object. Format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (32 hexadecimal characters with hyphens). Do NOT use placeholder strings like 'COMPANY\_ID' or 'RECORD\_ID' - only actual UUIDs are accepted. Obtain this value from previous API responses (e.g., ATTIO\_CREATE\_RECORD, ATTIO\_FIND\_RECORD, ATTIO\_LIST\_RECORDS). |

***

### `Attio Create Object`

Integration name: **ATTIO\_CREATE\_OBJECT**

Tool to create a new custom object in your Attio workspace. Use when you need to add a new object type beyond the standard objects (people, companies, deals, users, workspaces). Requires api\_slug (snake\_case identifier), singular\_noun, and plural\_noun.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example | Description                                                                                                                       |
| --------- | ------ | :------: | ------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `data`    | object |     ✅    | —       | The object configuration with API slug, singular noun, and plural noun. All three fields are required when creating a new object. |

***

### `Attio Create Person`

Integration name: **ATTIO\_CREATE\_PERSON**

Creates a new person record in Attio. This endpoint will throw an error on conflicts of unique attributes like email\_addresses. If you prefer to update person records on conflicts instead, use the Assert person record endpoint. Note: The avatar\_url attribute cannot currently be set via the API.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                                                            | Description                                                                                                                                                                                                                                                                                                                         |
| ------------------ | ------ | :------: | ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`             | array  |          | `[{"full_name":"John Doe","last_name":"Doe","first_name":"John"}]` | Person's name. Provide as array with first\_name, last\_name, and/or full\_name. If only full\_name is provided, it will be auto-split into first\_name and last\_name. If only first\_name and/or last\_name are provided, full\_name will be auto-generated.                                                                      |
| `company`          | array  |          | `["92446133-64cf-4f83-bca9-594ca2f8da57"]`                         | Associated company record IDs (UUIDs) to link this person to companies                                                                                                                                                                                                                                                              |
| `linkedin`         | string |          | `"https://www.linkedin.com/in/johndoe"`                            | LinkedIn profile URL                                                                                                                                                                                                                                                                                                                |
| `job_title`        | string |          | `"Software Engineer"`                                              | Person's job title                                                                                                                                                                                                                                                                                                                  |
| `description`      | string |          | `"Senior software engineer specializing in backend development"`   | Description of the person                                                                                                                                                                                                                                                                                                           |
| `phone_numbers`    | array  |          | `["+15558675309","+442071234567"]`                                 | Person's phone numbers in E.164 international format (leading '+' and country code, e.g. '+15558675309', '+442071234567'). 10-digit numeric inputs are auto-prefixed with '+1' (US). Common formatting characters (spaces, dashes, parens, dots) are stripped. Numbers that cannot be normalized are rejected with a helpful error. |
| `email_addresses`  | array  |          | `["john@example.com"]`                                             | Person's email addresses. This field has a uniqueness constraint - the endpoint will throw an error if any email conflicts with an existing person record. If you prefer to update records on conflicts instead, use the Assert person record endpoint.                                                                             |
| `primary_location` | —      |          | `"1 Infinite Loop, Cupertino, CA, 95014, US"`                      | Person's primary location. Use string format: '1 Infinite Loop, Cupertino, CA, 95014, US' (recommended). Alternatively, you can provide an object with location fields like line\_1, line\_2, city, state, postal\_code, country\_code, etc.                                                                                        |

***

### `Attio Create Record`

Integration name: **ATTIO\_CREATE\_RECORD**

This tool creates a new record in Attio for a specified object type (people, companies, deals, users, workspaces, etc.). It requires the object type and a values dictionary containing the attributes for the new record. IMPORTANT: Different object types have different attributes. For example: - 'people' object uses: name, email\_addresses, phone\_numbers, primary\_location, job\_title, etc. - 'users' object uses: primary\_email\_address, user\_id, person, workspace - 'companies' object uses: name, domains, description, etc. Always verify the correct attribute names for your target object type before creating records. Use the List Attributes API or check your workspace to see available attributes for each object type.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------- | ------ | :------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `values`      | object |     ✅    | `{"name":[{"full_name":"John Doe","last_name":"Doe","first_name":"John"}],"job_title":"Software Engineer","phone_numbers":[{"country_code":"US","original_phone_number":"+15558675309"}],"email_addresses":[{"email_address":"john@example.com"}],"primary_location":[{"line_1":"1 Infinite Loop","line_2":null,"line_3":null,"line_4":null,"region":"CA","latitude":"37.331741","locality":"Cupertino","postcode":"95014","longitude":"-122.030333","country_code":"US"}]}` | Attribute values for the new record. Keys are attribute slugs, values are attribute data. CRITICAL: Call ATTIO\_LIST\_ATTRIBUTES (target='objects', identifier=\<object\_type>) to discover valid slugs and required attributes (is\_required=true) BEFORE creating records. Do NOT guess attribute names. **OBJECT-SPECIFIC ATTRIBUTES**: (1) 'people': 'name' (personal-name), 'email\_addresses', 'phone\_numbers', 'primary\_location', 'job\_title', 'company' (record-reference to companies). (2) 'companies': 'name' (text), 'domains', 'description', 'primary\_location', 'team' (record-reference to people). (3) 'deals': 'name' (deal title), 'owner' (actor-reference), 'stage' (status), 'value' (currency), 'associated\_company' (record-reference to companies), 'associated\_people' (record-reference to people). (4) 'users': 'primary\_email\_address', 'user\_id', 'person', 'workspace'. (5) Custom objects: slugs are workspace-specific, always use List Attributes. **VALUE FORMATS**: Multi-value attributes (email-address, phone-number, personal-name, location, domain) require arrays. Single-value attributes (text, number) accept simple values or single-element arrays. personal-name: requires 'first\_name', 'last\_name', 'full\_name' (full\_name auto-generated if omitted). email-address: use 'email\_address'. phone-number: use 'original\_phone\_number'. **ACTOR-REFERENCE** (e.g., 'owner', 'created\_by'): Reference workspace members by email address. Formats: email string, array with email, or object with workspace\_member\_email\_address field. **RECORD-REFERENCE** (e.g., 'company', 'associated\_company'): Include target\_object (API slug, e.g., 'people', 'companies') and target\_record\_id (UUID). Format: \[{"target\_object": "", "target\_record\_id": ""}]. **STATUS** (e.g., 'stage' for deals): Format: \[{"status": "\<title\_or\_uuid>"}]. Use ATTIO\_LIST\_ATTRIBUTE\_STATUSES to get available statuses. **LOCATION**: Use string format (recommended) or object with fields: line\_1, line\_2, line\_3, line\_4, locality, region, postcode, country\_code, latitude, longitude. **DOMAIN**: use \["example.com"] or \[{"domain": "example.com"}]. 'root\_domain' is output-only. **CURRENCY**: Use \[{"currency\_value": 1000.00}] or simple number. |
| `object_type` | string |     ✅    | `"people"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | The type of object to create a record for. Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'. You can also use custom object types from your workspace. IMPORTANT: Each object type has different attributes - you must use the correct attribute names for the specific object type you're creating.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

***

### `Attio Create Select Option`

Integration name: **ATTIO\_CREATE\_SELECT\_OPTION**

Tool to add a new select option to a select or multiselect attribute in Attio. Use when you need to add a new choice to an existing select field.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example       | Description                                                                   |
| ------------ | ------ | :------: | ------------- | ----------------------------------------------------------------------------- |
| `data`       | object |     ✅    | —             | The data for the new select option                                            |
| `target`     | string |     ✅    | `"objects"`   | Whether the attribute is on an object or a list                               |
| `attribute`  | string |     ✅    | `"priority"`  | A UUID or slug to identify the select or multiselect attribute                |
| `identifier` | string |     ✅    | `"companies"` | A UUID or slug to identify the object or list the select attribute belongs to |

***

### `Attio Create Status`

Integration name: **ATTIO\_CREATE\_STATUS**

Tool to add a new status to a status attribute on either an object or a list. Use when you need to create a new status option for status attributes. Company and person objects do not support status attributes at this time.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                  | Description                                                                                                                          |
| ------------ | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `data`       | object |     ✅    | —                                        | The status data containing the title and optional configuration.                                                                     |
| `target`     | string |     ✅    | `"lists"`                                | Whether the attribute is on an object or a list. Note that company and person objects do not support status attributes at this time. |
| `attribute`  | string |     ✅    | `"41252299-f8c7-4b5e-99c9-4ff8321d2f96"` | A UUID or slug to identify the attribute the status will belong to.                                                                  |
| `identifier` | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"` | A UUID or slug to identify the object or list the status attribute belongs to.                                                       |

***

### `Attio Create Task`

Integration name: **ATTIO\_CREATE\_TASK**

Tool to create a new task in Attio. Use when you need to add a task with content and optional deadline, assignees, or linked records. Note: Tasks can only be created from plaintext without record reference formatting.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter        | Type    | Required | Example                                     | Description                                                                                                                                                                                               |
| ---------------- | ------- | :------: | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content`        | string  |     ✅    | `"Follow up on current software solutions"` | The text content of the task. A maximum length of 2000 characters is enforced.                                                                                                                            |
| `assignees`      | array   |          | —                                           | Workspace members assigned to this task. Provide an array of objects with 'referenced\_actor\_type' and 'referenced\_actor\_id' properties.                                                               |
| `deadline_at`    | string  |          | `"2023-01-01T15:00:00.000000000Z"`          | The deadline of the task, in ISO 8601 format. Set to null if no deadline.                                                                                                                                 |
| `is_completed`   | boolean |          | `false`                                     | Whether the task has been completed.                                                                                                                                                                      |
| `linked_records` | array   |          | —                                           | Records linked to the task. Provide an array of objects with 'target\_object' and 'target\_record\_id' properties. Creating record links within task content text is not possible via the API at present. |

***

### `Attio Create User Record`

Integration name: **ATTIO\_CREATE\_USER\_RECORD**

Creates a new user record in Attio. User records represent workspace members or users in the system. Requires primary\_email\_address, user\_id, and workspace\_id. Optionally link to an existing person record. Note: Required attributes may vary based on workspace configuration - check the List Attributes action if you encounter missing\_value errors.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter               | Type   | Required | Example                                  | Description                                                                                                                            |
| ----------------------- | ------ | :------: | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `user_id`               | string |     ✅    | `"test-user-123"`                        | Unique identifier for the user. This should be a unique string value that identifies the user in your system.                          |
| `person_id`             | string |          | `"a1b2c3d4-e5f6-7890-abcd-ef1234567890"` | Optional UUID of a person record to link this user to. If provided, this associates the user with an existing person in the workspace. |
| `workspace_id`          | string |     ✅    | `"07774c6b-5b0a-4142-b708-585a310d0d04"` | UUID of the workspace this user should belong to. Get workspace IDs using the List Workspace Records action.                           |
| `primary_email_address` | string |     ✅    | `"test.user@example.com"`                | Primary email address for the user. This is the email that will be used for user authentication and notifications.                     |

***

### `Attio Create Webhook`

Integration name: **ATTIO\_CREATE\_WEBHOOK**

Tool to create a webhook and subscribe to events in Attio. Use when you need to set up a new webhook endpoint to receive real-time event notifications. Returns the webhook configuration including a one-time signing secret for verifying event authenticity.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                                      | Description                                                                                                                |
| --------------- | ------ | :------: | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `target_url`    | string |     ✅    | `"https://webhook.site/unique-endpoint-url"` | URL where the webhook events will be delivered to. Must be an HTTPS URL starting with 'https\://'.                         |
| `subscriptions` | array  |     ✅    | —                                            | One or more event subscriptions for the webhook. Each subscription specifies an event type and optional filter conditions. |

***

### `Attio Create Workspace Record`

Integration name: **ATTIO\_CREATE\_WORKSPACE\_RECORD**

Creates a new workspace record in Attio. The workspace\_id field is required and must be unique. This endpoint will throw an error on conflicts of unique attributes. Use when you need to create a new workspace entry in your Attio workspace.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                           | Description                                                                                                                           |
| -------------- | ------ | :------: | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `name`         | string |          | `"Production Workspace"`                                          | The name of the workspace                                                                                                             |
| `users`        | array  |          | `[{"target_object":"users","target_record_id":"abc-123-def"}]`    | User records associated with this Workspace (record-reference type). Format: \[{'target\_object': 'users', 'target\_record\_id': ''}] |
| `company`      | object |          | `{"target_object":"companies","target_record_id":"company-uuid"}` | A related Company record (record-reference type). Format: {'target\_object': 'companies', 'target\_record\_id': ''}                   |
| `avatar_url`   | string |          | `"https://example.com/avatar.png"`                                | The URL of an avatar image                                                                                                            |
| `workspace_id` | string |     ✅    | `"test-workspace-1739381532"`                                     | A unique identifier for this Workspace in your system. This is a required and unique attribute.                                       |

***

### `Attio Delete Comment`

Integration name: **ATTIO\_DELETE\_COMMENT**

Tool to delete a comment by its comment\_id. Use when you need to remove a comment from Attio. If the comment is at the head of a thread, all messages in the thread are also deleted. The operation is permanent and cannot be undone.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                  | Description                                                                                                                  |
| ------------ | ------ | :------: | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `comment_id` | string |     ✅    | `"9d1695bb-eb63-443e-ba77-45f45344365d"` | The ID of the comment to delete. If deleting a comment at the head of a thread, all messages in the thread are also deleted. |

***

### `Attio Delete Company`

Integration name: **ATTIO\_DELETE\_COMPANY**

Tool to delete a company record from Attio by its record\_id. Use when you need to permanently remove a company record. The deletion is irreversible and cannot be recovered.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                                  |
| ----------- | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------ |
| `record_id` | string |     ✅    | `"99a03ff3-0435-47da-95cc-76b2caeb4dab"` | The unique identifier (UUID) of the company record to delete |

***

### `Attio Delete Deal`

Integration name: **ATTIO\_DELETE\_DEAL**

Tool to delete a deal record from Attio by its record\_id. Use when you need to permanently remove a deal record. The deletion is irreversible and cannot be recovered.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                               |
| ----------- | ------ | :------: | ---------------------------------------- | --------------------------------------------------------- |
| `record_id` | string |     ✅    | `"e11c655a-9b23-4891-a27d-078a87ac0cce"` | The unique identifier (UUID) of the deal record to delete |

***

### `Attio Delete Entry`

Integration name: **ATTIO\_DELETE\_ENTRY**

Tool to delete a single list entry by its entry\_id in Attio. Use when you need to remove an entry from a specific list. The operation is permanent and cannot be undone.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example                                  | Description                                         |
| ---------- | ------ | :------: | ---------------------------------------- | --------------------------------------------------- |
| `list`     | string |     ✅    | `"enterprise_sales"`                     | A UUID or slug identifying the list the entry is in |
| `entry_id` | string |     ✅    | `"2e6e29ea-c4e0-4f44-842d-78a891f8c156"` | A UUID identifying the entry to delete              |

***

### `Attio Delete Note`

Integration name: **ATTIO\_DELETE\_NOTE**

This tool allows users to delete a specific note in Attio by its ID. It is implemented via DELETE <https://api.attio.com/v2/notes/{note\\_id}> and handles note deletion by validating the provided note\_id. It complements ATTIO\_CREATE\_NOTE functionality, providing complete note management capabilities within the Attio platform.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example         | Description                  |
| --------- | ------ | :------: | --------------- | ---------------------------- |
| `note_id` | string |     ✅    | `"note_123abc"` | The ID of the note to delete |

***

### `Attio Delete Person`

Integration name: **ATTIO\_DELETE\_PERSON**

Tool to delete a person record from Attio by its record\_id. Use when you need to permanently remove a person record. The deletion is irreversible and cannot be recovered.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                                 |
| ----------- | ------ | :------: | ---------------------------------------- | ----------------------------------------------------------- |
| `record_id` | string |     ✅    | `"53d69b95-66f6-4dd3-860d-32be1b6e837c"` | The unique identifier (UUID) of the person record to delete |

***

### `Attio Delete Record`

Integration name: **ATTIO\_DELETE\_RECORD**

This tool allows you to delete a record from Attio permanently. The deletion is irreversible, and the data will eventually be removed from the system.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                            | Description                                                                                                                                                                  |
| ------------- | ------ | :------: | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `record_id`   | string |     ✅    | `"rec_01H3PQWSN8KZQKM6KX2XS4W8PJ"` | The unique identifier of the record to delete                                                                                                                                |
| `object_type` | string |     ✅    | `"people"`                         | The type of object to delete. Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'. You can also use custom object types from your workspace. |

***

### `Attio Delete Task`

Integration name: **ATTIO\_DELETE\_TASK**

Tool to delete a task by its task\_id. Use when you need to remove a task from Attio. The operation is permanent and cannot be undone.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                  | Description                   |
| --------- | ------ | :------: | ---------------------------------------- | ----------------------------- |
| `task_id` | string |     ✅    | `"649e34f4-c39a-4f4d-99ef-48a36bef8f04"` | The ID of the task to delete. |

***

### `Attio Delete User`

Integration name: **ATTIO\_DELETE\_USER**

Tool to delete a user record from Attio by its record\_id. Use when you need to permanently remove a user record. The deletion is irreversible and cannot be recovered.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                               |
| ----------- | ------ | :------: | ---------------------------------------- | --------------------------------------------------------- |
| `record_id` | string |     ✅    | `"1153dd53-f5c1-5cc7-b76b-aa50f2b88c29"` | The unique identifier (UUID) of the user record to delete |

***

### `Attio Delete Webhook`

Integration name: **ATTIO\_DELETE\_WEBHOOK**

Tool to delete a webhook by its webhook\_id. Use when you need to remove a webhook subscription from Attio. The operation is permanent and cannot be undone.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                  | Description                               |
| ------------ | ------ | :------: | ---------------------------------------- | ----------------------------------------- |
| `webhook_id` | string |     ✅    | `"23e42eaf-323a-41da-b5bb-fd67eebda553"` | A UUID identifying the webhook to delete. |

***

### `Attio Delete Workspace Record`

Integration name: **ATTIO\_DELETE\_WORKSPACE\_RECORD**

Tool to delete a workspace record from Attio by its record\_id. Use when you need to permanently remove a workspace record. The deletion is irreversible and cannot be recovered.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                |
| ----------- | ------ | :------: | ---------------------------------------- | ------------------------------------------ |
| `record_id` | string |     ✅    | `"70887fd0-b0ad-44cd-ab5d-191ef8dead2d"` | The UUID of the workspace record to delete |

***

### `Attio Find Record`

Integration name: **ATTIO\_FIND\_RECORD**

This tool allows users to find a record in Attio by either its unique ID or by searching using unique attributes. It provides two methods: one for directly retrieving a record by its ID with the GET /v2/objects/{object}/records/{record\_id} endpoint, and another for searching by attributes using the POST /v2/objects/{object}/records/query endpoint.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------ | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | —                                        | Maximum number of records to return when searching.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `offset`     | integer |          | —                                        | Number of records to skip for pagination                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `object_id`  | string  |     ✅    | `"people"`                               | The UUID or slug identifying the object type to search in. Standard object type slugs include 'people', 'companies', 'deals', 'users', 'workspaces'. Note: 'lists' is NOT a valid object type - use list-specific actions (e.g., ATTIO\_LIST\_LISTS, ATTIO\_LIST\_LIST\_ENTRIES) to work with lists. Can also use 'object\_type' as an alias for this field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `record_id`  | string  |          | `"f3b2962b-febb-4e01-8431-f7ffb4d87e5e"` | The unique ID of the record to retrieve directly                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `attributes` | object  |          | `{"email_addresses":"john@example.com"}` | Dictionary of attributes to search by using attribute slugs. CRITICAL: Validate slugs via ATTIO\_LIST\_ATTRIBUTES (target='objects', identifier=\<object\_id>) before filtering. System attributes (e.g., 'email\_addresses', 'name') are consistent across workspaces; custom attributes vary and invalid slugs cause 'unknown\_filter\_attribute\_slug' errors. Filtering syntax: - Simple values use shorthand ($eq implied) - Single-element lists unwrap to shorthand - Multi-element lists convert to $or conditions - Dict values with operators ({'$eq': v}, {'$contains': v}, {'$not\_empty': true}) pass through unchanged - Select/multi-select: use Attio option slugs or IDs (not plain text) - Record-reference (e.g., 'team', 'company'): to filter by referenced record attributes, use path filtering: {'path': \[\['object', 'attribute'], \['target\_object', 'target\_attribute']], 'constraints': {...}}. Nested field syntax like {'team': {'name': {...}}} is NOT supported. To filter by record\_id directly: {'attribute\_slug': {'target\_object': 'type', 'target\_record\_id': 'uuid'}}. - Interaction attributes (e.g., 'last\_email\_interaction'): filter on sub-properties: owner\_actor (nested type/id), interacted\_at ($eq/$gte/$gt/$lte/$lt, ISO 8601), interaction\_type ($eq/$not\_empty) |

***

### `Attio Get Attribute`

Integration name: **ATTIO\_GET\_ATTRIBUTE**

Tool to get information about a single attribute on either an object or a list. Use when you need detailed information about a specific attribute's configuration, type, or metadata.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example       | Description                                                                                                                                                                          |
| ------------ | ------ | :------: | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `target`     | string |     ✅    | `"objects"`   | Whether the attribute is on an object or a list.                                                                                                                                     |
| `attribute`  | string |     ✅    | `"name"`      | A UUID or slug to identify the attribute to retrieve.                                                                                                                                |
| `identifier` | string |     ✅    | `"companies"` | A UUID or slug to identify the object or list the attribute belongs to. For objects, use slugs like 'people', 'companies', 'deals', or a UUID. For lists, use the list slug or UUID. |

***

### `Attio Get Comment`

Integration name: **ATTIO\_GET\_COMMENT**

Tool to get a single comment by its comment\_id in Attio. Use when you need to retrieve detailed information about a specific comment, including its content, author, thread, and resolution status.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                  | Description                                      |
| ------------ | ------ | :------: | ---------------------------------------- | ------------------------------------------------ |
| `comment_id` | string |     ✅    | `"aa1dc1d9-93ac-4c6c-987e-16b6eea9aab2"` | A UUID which identifies the comment to retrieve. |

***

### `Attio Get Company`

Integration name: **ATTIO\_GET\_COMPANY**

Tool to get a single company record by its record\_id in Attio. Use when you need to retrieve detailed information about a specific company. Returns all attribute values for the company with temporal and audit metadata.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                     |
| ----------- | ------ | :------: | ---------------------------------------- | ----------------------------------------------- |
| `record_id` | string |     ✅    | `"0059945e-fdff-4ae1-a200-5995bdfd7831"` | UUID identifying the company record to retrieve |

***

### `Attio Get Deal Record`

Integration name: **ATTIO\_GET\_DEAL\_RECORD**

Tool to get a single deal record by its record\_id in Attio. Use when you need to retrieve detailed information about a specific deal. Returns all attribute values for the deal with temporal and audit metadata.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                  |
| ----------- | ------ | :------: | ---------------------------------------- | -------------------------------------------- |
| `record_id` | string |     ✅    | `"7f454ed2-3069-4ea2-9b84-21edb1df82b5"` | UUID identifying the deal record to retrieve |

***

### `Attio Get List`

Integration name: **ATTIO\_GET\_LIST**

Tool to retrieve details of a single list in your Attio workspace. Use when you need to get information about a specific list by its UUID or slug.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                  | Description                          |
| --------- | ------ | :------: | ---------------------------------------- | ------------------------------------ |
| `list`    | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"` | A UUID or slug to identify the list. |

***

### `Attio Get List Entry`

Integration name: **ATTIO\_GET\_LIST\_ENTRY**

Tool to get a single list entry by its entry\_id. Use when you need to retrieve detailed information about a specific entry in an Attio list.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter  | Type   | Required | Example                                  | Description                                          |
| ---------- | ------ | :------: | ---------------------------------------- | ---------------------------------------------------- |
| `list`     | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"` | A UUID or slug identifying the list the entry is in. |
| `entry_id` | string |     ✅    | `"2e6e29ea-c4e0-4f44-842d-78a891f8c156"` | A UUID identifying the entry.                        |

***

### `Attio Get Note`

Integration name: **ATTIO\_GET\_NOTE**

Tool to get a single note by its note\_id in Attio. Use when you need to retrieve detailed information about a specific note, including its title, content (plaintext and markdown), tags, and creator information.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                  | Description                                   |
| --------- | ------ | :------: | ---------------------------------------- | --------------------------------------------- |
| `note_id` | string |     ✅    | `"ff3f3bd4-40f4-4f80-8187-cd02385af424"` | A UUID which identifies the note to retrieve. |

***

### `Attio Get Object`

Integration name: **ATTIO\_GET\_OBJECT**

Tool to get a single object by its object\_id or slug. Use to retrieve detailed schema information about a specific object type in the Attio workspace. Also use as a prerequisite validation step before calling ATTIO\_FIND\_RECORD, ATTIO\_LIST\_RECORDS, or ATTIO\_CREATE\_RECORD — attribute slugs must exactly match what this tool returns. The returned schema defines required attributes for record creation; omitting them causes invalid\_request\_error with code missing\_value (HTTP 400). Custom attributes (e.g., industry, category) vary by object type — verify their presence and data type here before building filters or record values.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example    | Description                                                                                                                                                                                                                                                                                           |
| --------- | ------ | :------: | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`  | string |     ✅    | `"people"` | A UUID or slug to identify the object. Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'. Use ATTIO\_LIST\_OBJECTS alongside this tool to confirm object slugs — some concepts (e.g., tasks) may be modeled as deals or custom objects rather than dedicated types. |

***

### `Attio Get Record`

Integration name: **ATTIO\_GET\_RECORD**

DEPRECATED: Use ATTIO\_FIND\_RECORD instead. Tool to get a single person, company, or other record by its record\_id in Attio. Use when you need to retrieve detailed information about a specific record. Returns all attribute values for the record with temporal and audit metadata.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                                  | Description                                                                                                                                                                                                                                      |
| ------------- | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `record_id`   | string |     ✅    | `"bf071e1f-6035-429d-b874-d83ea64ea13b"` | A UUID identifying the record Must be paired with the correct object\_type — using a record\_id from one object type with a different object\_type will fail. Always use object\_type and record\_id together as retrieved from prior responses. |
| `object_type` | string |     ✅    | `"people"`                               | A UUID or slug identifying the object that the record belongs to. Can also use 'object' as an alias for this field.                                                                                                                              |

***

### `Attio Get Record Entries`

Integration name: **ATTIO\_GET\_RECORD\_ENTRIES**

Tool to list all entries, across all lists, for which a record is the parent. Use when you need to find which lists a specific record belongs to. Returns list IDs, slugs, entry IDs, and creation timestamps.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example                                  | Description                                                                          |
| ----------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------ |
| `limit`     | integer |          | —                                        | The maximum number of results to return. The default is 100 and the maximum is 1000. |
| `object`    | string  |     ✅    | `"people"`                               | A UUID or slug identifying the object that the record belongs to.                    |
| `offset`    | integer |          | —                                        | The number of results to skip over before returning. The default is 0.               |
| `record_id` | string  |     ✅    | `"891dcbfc-9141-415d-9b2a-2238a6cc012d"` | A UUID identifying the record.                                                       |

***

### `Attio Get Self`

Integration name: **ATTIO\_GET\_SELF**

Tool to identify the current access token, the workspace it is linked to, and any permissions it has. Use when you need to verify token validity or retrieve workspace information associated with the current authentication.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Attio Get Task`

Integration name: **ATTIO\_GET\_TASK**

Tool to get a single task by its task\_id in Attio. Use when you need to retrieve detailed information about a specific task, including its content, deadline, assignees, and linked records.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                  | Description                     |
| --------- | ------ | :------: | ---------------------------------------- | ------------------------------- |
| `task_id` | string |     ✅    | `"649e34f4-c39a-4f4d-99ef-48a36bef8f04"` | The ID of the task to retrieve. |

***

### `Attio Get V2 Objects Object Records Record Id`

Integration name: **ATTIO\_GET\_V2\_OBJECTS\_OBJECT\_RECORDS\_RECORD\_ID**

DEPRECATED: Use ATTIO\_FIND\_RECORD instead. Tool to get a single person, company or other record by its record\_id. Use when you need to retrieve detailed information about a specific record.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                                       |
| ----------- | ------ | :------: | ---------------------------------------- | ----------------------------------------------------------------- |
| `object`    | string |     ✅    | `"people"`                               | A UUID or slug identifying the object that the record belongs to. |
| `record_id` | string |     ✅    | `"891dcbfc-9141-415d-9b2a-2238a6cc012d"` | A UUID identifying the record.                                    |

***

### `Attio Get V2 Tasks`

Integration name: **ATTIO\_GET\_V2\_TASKS**

Tool to list all tasks in the workspace. Use when you need to retrieve tasks, optionally filtering by assignee, completion status, or linked records. Results are sorted by creation date from oldest to newest by default.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                                  | Description                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------ | ------- | :------: | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sort`             | string  |          | `"created_at:asc"`                       | Optionally sort the results. "created\_at:asc" returns oldest results first, "created\_at:desc" returns the newest results first. If unspecified, defaults to "created\_at:asc" (oldest results first).                                                                                                                                                                                               |
| `limit`            | integer |          | `10`                                     | The maximum number of results to return. Defaults to 500.                                                                                                                                                                                                                                                                                                                                             |
| `offset`           | integer |          | `0`                                      | The number of results to skip over before returning. Defaults to 0.                                                                                                                                                                                                                                                                                                                                   |
| `assignee`         | string  |          | `"user@example.com"`                     | Filter tasks by workspace member assignees. Workspace members can be referenced by either their email address or ID. Pass an empty value or the string `null` to find tasks with no assignee.                                                                                                                                                                                                         |
| `is_completed`     | boolean |          | `true`                                   | Filter tasks by whether they have been completed. By default, both completed and non-completed tasks are returned. Specify `true` to only return completed tasks, or `false` to only return non-completed tasks.                                                                                                                                                                                      |
| `linked_object`    | string  |          | `"people"`                               | Pass a value to this parameter to filter results to only those tasks that contain the specified record in the `linked_records` property of the task. This parameter should identify the object that the linked record belongs to. For example, if filtering to tasks that link to a specific person record, this parameter should be `people`. If provided, `linked_record_id` must also be provided. |
| `linked_record_id` | string  |          | `"891dcbfc-9141-415d-9b2a-2238a6cc012d"` | Pass a value to this parameter to filter results to only those tasks that contain the specified record in the `linked_records` property of the task. This parameter should contain the record ID of the linked record. If provided, `linked_object` must also be provided.                                                                                                                            |

***

### `Attio Get V2 Workspace Members`

Integration name: **ATTIO\_GET\_V2\_WORKSPACE\_MEMBERS**

DEPRECATED: Use ATTIO\_LIST\_WORKSPACE\_MEMBERS instead. Tool to list all workspace members in the workspace. Use when you need to retrieve information about workspace members, their access levels, or their identities.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Attio Get Webhook`

Integration name: **ATTIO\_GET\_WEBHOOK**

Tool to get a single webhook by its webhook\_id in Attio. Use when you need to retrieve detailed information about a specific webhook configuration. Returns the webhook's target URL, event subscriptions, status, and metadata.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                  | Description                          |
| ------------ | ------ | :------: | ---------------------------------------- | ------------------------------------ |
| `webhook_id` | string |     ✅    | `"23e42eaf-323a-41da-b5bb-fd67eebda553"` | A UUID which identifies the webhook. |

***

### `Attio Get Workspace Member`

Integration name: **ATTIO\_GET\_WORKSPACE\_MEMBER**

Tool to get a single workspace member by their workspace\_member\_id. Use when you need details about a specific workspace member, including their name, email, access level, and avatar.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter             | Type   | Required | Example                                  | Description                             |
| --------------------- | ------ | :------: | ---------------------------------------- | --------------------------------------- |
| `workspace_member_id` | string |     ✅    | `"50cf242c-7fa3-4cad-87d0-75b1af71c57b"` | A UUID to identify the workspace member |

***

### `Attio Get Workspace Record`

Integration name: **ATTIO\_GET\_WORKSPACE\_RECORD**

Tool to get a single workspace record by its record\_id. Use when you need to retrieve detailed information about a specific workspace. Returns all attribute values for the workspace record with temporal and audit metadata.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                   | Description                                           |
| ----------- | ------ | :------: | ----------------------------------------- | ----------------------------------------------------- |
| `record_id` | string |     ✅    | `"72ef5feaf-4919-4208-b332-1339ab8ba040"` | UUID string identifying the workspace record to fetch |

***

### `Attio List Attribute Options`

Integration name: **ATTIO\_LIST\_ATTRIBUTE\_OPTIONS**

Tool to list all select options for a particular attribute on either an object or a list. Use when you need to discover available options for select or status type attributes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example        | Description                                                                                                                                                                        |
| --------------- | ------- | :------: | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | —              | The maximum number of results to return for pagination purposes.                                                                                                                   |
| `offset`        | integer |          | —              | The number of results to skip before returning results.                                                                                                                            |
| `target`        | string  |     ✅    | `"objects"`    | Whether the attribute is on an object or a list.                                                                                                                                   |
| `attribute`     | string  |     ✅    | `"categories"` | A UUID or slug to identify the attribute you want to list select options on. This must be a select or status type attribute.                                                       |
| `identifier`    | string  |     ✅    | `"companies"`  | A UUID or slug to identify the object or list the select attribute belongs to. For objects, use slugs like 'companies', 'people', or a UUID. For lists, use the list slug or UUID. |
| `show_archived` | boolean |          | —              | Set to true if you want the results to include archived select options. Defaults to false.                                                                                         |

***

### `Attio List Attributes`

Integration name: **ATTIO\_LIST\_ATTRIBUTES**

Tool to list the attribute schema for an Attio object or list (including slugs, types, select/status config) to enable correct filtering and writes. Use when you need to discover what attributes exist on an object or list, their types, and their configuration (e.g., available options for select/status attributes). Returns attributes in UI sort order.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example     | Description                                                                                                                                                                          |
| --------------- | ------- | :------: | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`         | integer |          | —           | The maximum number of results to return for pagination.                                                                                                                              |
| `offset`        | integer |          | —           | The number of results to skip before returning results.                                                                                                                              |
| `target`        | string  |     ✅    | `"objects"` | Whether the attributes are on an object or a list.                                                                                                                                   |
| `identifier`    | string  |     ✅    | `"people"`  | A UUID or slug to identify the object or list the attributes belong to. For objects, use slugs like 'people', 'companies', 'deals', or a UUID. For lists, use the list slug or UUID. |
| `show_archived` | boolean |          | —           | Whether archived attributes should be included in the results.                                                                                                                       |

***

### `Attio List Attribute Statuses`

Integration name: **ATTIO\_LIST\_ATTRIBUTE\_STATUSES**

Tool to list all statuses for a particular status attribute on either an object or a list. Use when you need to discover available statuses for a status attribute, including their IDs, titles, and configuration.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                  | Description                                                                                                                                     |
| --------------- | ------- | :------: | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `target`        | string  |     ✅    | `"lists"`                                | Whether the attribute is on an object or a list. Please note that the company and people objects do not support status attributes at this time. |
| `attribute`     | string  |     ✅    | `"41252299-f8c7-4b5e-99c9-4ff8321d2f96"` | A UUID or slug to identify the attribute you want to list statuses on.                                                                          |
| `identifier`    | string  |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"` | A UUID or slug to identify the object or list the status attribute belongs to.                                                                  |
| `show_archived` | boolean |          | —                                        | True if you want the results to include archived statuses. Defaults to false if not specified.                                                  |

***

### `Attio List Call Recordings`

Integration name: **ATTIO\_LIST\_CALL\_RECORDINGS**

Tool to list all call recordings for a meeting in Attio. Use when you need to retrieve call recordings associated with a specific meeting. This endpoint is in beta.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example                                                                          | Description                                                                                               |
| ------------ | ------- | :------: | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | —                                                                                | The maximum number of results to return. Defaults to 50 with a maximum of 200.                            |
| `cursor`     | string  |          | `"eyJkZXNjcmlwdGlvbiI6ICJ0aGlzIGlzIGEgY3Vyc29yIn0=.eM56CGbqZ6G1NHiJchTIkH4vKDr"` | A cursor for pagination. Use the next\_cursor from the previous response to get the next page of results. |
| `meeting_id` | string  |     ✅    | `"cb59ab17-ad15-460c-a126-0715617c0853"`                                         | The UUID of the meeting to list call recordings for. Must be in UUID format.                              |

***

### `Attio List Companies`

Integration name: **ATTIO\_LIST\_COMPANIES**

Tool to list company records in Attio with optional filtering and sorting. Use when you need to retrieve company records based on criteria like domain, name, or description.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| --------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —       | Maximum number of records to return. Defaults to 25.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `sorts`   | array   |          | —       | Array of sort specifications to order results. Each sort object specifies direction ('asc'/'desc'), attribute, and optionally field or path.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `filter`  | object  |          | —       | Attio filter object for server-side filtering. Supports both shorthand and verbose syntax with operators. Filter by attribute slugs (e.g., 'name', 'domains', 'description'). Multi-field attributes must be accessed via nested syntax: {'domains': {'domain': {'$eq': 'attio.com'}}}. Available operators: $eq (equality), $not\_empty (presence check), $in (set membership), $contains (substring), $starts\_with (prefix), $ends\_with (suffix), $lt/$lte/$gt/$gte (numeric/date comparison), $and/$or/$not (logical). Examples: {'name': 'Acme'} for shorthand, {'domains': {'domain': {'$eq': 'example.com'}}} for exact domain match, {'$and': \[{'name': {'$contains': 'Inc'}}, {'description': {'value': {'$not\_empty': True}}}]} for complex queries. |
| `offset`  | integer |          | —       | Number of records to skip for pagination                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

***

### `Attio List Company Attribute Values`

Integration name: **ATTIO\_LIST\_COMPANY\_ATTRIBUTE\_VALUES**

Tool to get all values for a given attribute on a company record. Historic values can be queried using the show\_historic query param. Historic values cannot be queried on COMINT or enriched attributes. Some attributes are subject to billing status and may return an empty array.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                  | Description                                                                                                |
| --------------- | ------- | :------: | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | —                                        | Maximum number of results to return                                                                        |
| `offset`        | integer |          | —                                        | Number of results to skip                                                                                  |
| `attribute`     | string  |     ✅    | `"name"`                                 | A UUID or slug to identify the attribute                                                                   |
| `record_id`     | string  |     ✅    | `"0059945e-fdff-4ae1-a200-5995bdfd7831"` | A UUID of the company record to fetch attribute values for                                                 |
| `show_historic` | boolean |          | —                                        | If true, returns all historic values; defaults to false. Cannot be used with COMINT or enriched attributes |

***

### `Attio List Company Record Entries`

Integration name: **ATTIO\_LIST\_COMPANY\_RECORD\_ENTRIES**

Tool to list all entries across all lists for which a company record is the parent in Attio. Use when you need to see which lists a particular company record belongs to. Returns list information and entry IDs for each list the company appears in.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example                                  | Description                                                          |
| ----------- | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------------- |
| `limit`     | integer |          | —                                        | Maximum number of results to return. Default is 100, maximum is 1000 |
| `offset`    | integer |          | —                                        | Number of results to skip over before returning. Default is 0        |
| `record_id` | string  |     ✅    | `"01641312-4b94-4cbc-be9b-1e7770ce49a5"` | A UUID identifying the company record                                |

***

### `Attio List Deal Entries`

Integration name: **ATTIO\_LIST\_DEAL\_ENTRIES**

Tool to list all entries across all lists for which a deal record is the parent in Attio. Use when you need to see which lists a particular deal record belongs to. Returns list information and entry IDs for each list the deal appears in.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example                                  | Description                                                          |
| ----------- | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------------- |
| `limit`     | integer |          | —                                        | Maximum number of results to return. Default is 100, maximum is 1000 |
| `offset`    | integer |          | —                                        | Number of results to skip over before returning. Default is 0        |
| `record_id` | string  |     ✅    | `"12345678-1234-1234-1234-123456789012"` | A UUID identifying the deal record                                   |

***

### `Attio List Deal Record Attribute Values`

Integration name: **ATTIO\_LIST\_DEAL\_RECORD\_ATTRIBUTE\_VALUES**

Tool to retrieve all values for a specified attribute on a deal record in Attio. Use when you need to see current or historic values for a specific deal attribute. Historic values can be queried using show\_historic param but cannot be queried on COMINT or enriched attributes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                  | Description                                                                                                                                                                                     |
| --------------- | ------- | :------: | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | —                                        | Maximum number of results to return                                                                                                                                                             |
| `offset`        | integer |          | —                                        | Number of results to skip before returning                                                                                                                                                      |
| `attribute`     | string  |     ✅    | `"owner"`                                | UUID or slug to identify the attribute you want to query values on                                                                                                                              |
| `record_id`     | string  |     ✅    | `"1eec4535-30a1-4bc0-be24-e255d3fb5ac5"` | UUID of the deal record to fetch attribute values for                                                                                                                                           |
| `show_historic` | boolean |          | —                                        | If true, returns all historic values for the attribute. If false, returns only currently active value(s). Defaults to false. Cannot be set to true for COMINT attributes or enriched attributes |

***

### `Attio List Deal Records`

Integration name: **ATTIO\_LIST\_DEAL\_RECORDS**

Tool to list deal records in Attio with the option to filter and sort results. Use when you need to retrieve deal records based on filter criteria or sorting requirements.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                                                   |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —       | Maximum number of results to return. Defaults to 500                                                                                                          |
| `sorts`   | array   |          | —       | Array of sort objects with direction, attribute, and field properties                                                                                         |
| `filter`  | object  |          | —       | Filter results to a subset. Supports operators like $and, $or, $not, $eq, $contains. Example: {'name': {'$contains': 'Acme'}} or {'status': {'$eq': 'open'}}. |
| `offset`  | integer |          | —       | Number of results to skip. Defaults to 0                                                                                                                      |

***

### `Attio List Entries`

Integration name: **ATTIO\_LIST\_ENTRIES**

DEPRECATED: Use ATTIO\_ATTIO\_POST\_V2\_LISTS\_LIST\_ENTRIES\_QUERY instead. Tool to list entries in a given list with filtering and sorting options. Use when you need to retrieve records added to a specific list in Attio. Entries are returned based on the filters and sorts provided.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------- | ------- | :------: | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`   | integer |          | —                    | Maximum number of results to return. Maximum 500                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `sorts`   | array   |          | —                    | Array of sort objects to sort results by attributes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `filter`  | object  |          | —                    | Filter entries by attribute values. Keys are attribute slugs (e.g., 'name', 'categories'). For status attributes, values can be either (1) status title strings (case-sensitive, e.g., 'In Progress', 'Lead') or (2) status\_id UUIDs for advanced filtering. Status titles must match exactly. Use ATTIO\_LIST\_ATTRIBUTE\_STATUSES to discover valid status options for a list. Example with text field: {'name': 'Acme Corp'}. Example with status field using title: {'deal\_stage': 'In Progress'}. Example with status field using UUID: {'deal\_stage': '0ebdb78d-3c9f-42b4-9df8-cb9d8b402c00'} |
| `offset`  | integer |          | —                    | Number of results to skip over before returning                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `list_id` | string  |     ✅    | `"enterprise_sales"` | A UUID or slug identifying the list to retrieve entries from                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

***

### `Attio List List Entries`

Integration name: **ATTIO\_LIST\_LIST\_ENTRIES**

DEPRECATED: Use ATTIO\_ATTIO\_POST\_V2\_LISTS\_LIST\_ENTRIES\_QUERY instead. Tool to retrieve entries (records) that belong to a specific Attio list. Use when you need to enumerate list membership or access list-specific attribute values. This is distinct from listing all records of an object type - it specifically returns records that are members of a particular list.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example         | Description                                                                                                                                                           |
| --------- | ------- | :------: | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list`    | string  |     ✅    | `"people-list"` | UUID or API slug identifying the list to retrieve entries from                                                                                                        |
| `limit`   | integer |          | —               | Maximum number of entries to return. Defaults to 500.                                                                                                                 |
| `sorts`   | array   |          | —               | Optional array of sort descriptors to order results. Each descriptor contains direction ('asc' or 'desc'), attribute name, and optionally a field for nested sorting. |
| `filter`  | object  |          | —               | Optional filter object to retrieve a subset of entries. Object with attribute names as keys and values to match. Omit or pass empty object to enumerate all entries.  |
| `offset`  | integer |          | —               | Number of entries to skip for pagination. Defaults to 0.                                                                                                              |

***

### `Attio List List Entry Attribute Values`

Integration name: **ATTIO\_LIST\_LIST\_ENTRY\_ATTRIBUTE\_VALUES**

Tool to retrieve all values for a specified attribute on a list entry in Attio. Use when you need to see the history of values for a specific attribute on a list entry. Can return only active values or include all historical values sorted chronologically.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                  | Description                                                                                                                                                                                                                              |
| --------------- | ------- | :------: | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list`          | string  |     ✅    | `"press_outreach"`                       | A UUID or slug identifying the list the entry is in                                                                                                                                                                                      |
| `limit`         | integer |          | —                                        | Maximum number of results to return for pagination                                                                                                                                                                                       |
| `offset`        | integer |          | —                                        | Number of results to skip before returning                                                                                                                                                                                               |
| `entry_id`      | string  |     ✅    | `"2e6e29ea-c4e0-4f44-842d-78a891f8c156"` | A UUID identifying the entry                                                                                                                                                                                                             |
| `attribute`     | string  |     ✅    | `"status"`                               | A UUID or slug to identify the attribute you want to query values on                                                                                                                                                                     |
| `show_historic` | boolean |          | —                                        | If true, returns all historic values for the attribute. If false, returns only currently active value(s). Defaults to false. Can only be set to true for attributes which support historic data; will error for non-historic attributes. |

***

### `Attio List Lists`

Integration name: **ATTIO\_LIST\_LISTS**

This tool retrieves all lists available in the Attio workspace, sorted as they appear in the sidebar. Returns list metadata only (names, IDs, configuration) — not the records/entries within those lists. To fetch actual list entries, use ATTIO\_FIND\_RECORD with appropriate filters. This tool is a prerequisite for many list-related operations. Requires the list\_configuration:read permission scope.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Attio List Meetings`

Integration name: **ATTIO\_LIST\_MEETINGS**

Tool to list all meetings in the workspace using a deterministic sort order. Use when you need to retrieve meetings, optionally filtering by participants, linked records, or time ranges. This endpoint is in beta.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type    | Required | Example                                    | Description                                                                                                                                                                                                                                                                                                                                                      |
| ------------------ | ------- | :------: | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sort`             | string  |          | —                                          | The order in which to sort the meetings. Defaults to start\_asc (earliest meetings first).                                                                                                                                                                                                                                                                       |
| `limit`            | integer |          | `50`                                       | The maximum number of meetings to return. Must be between 1 and 200. Defaults to 50.                                                                                                                                                                                                                                                                             |
| `cursor`           | string  |          | —                                          | A pagination cursor used to fetch the next page of meetings. Responses with more meetings will include a cursor for you to use here. If not provided, the first page will be returned.                                                                                                                                                                           |
| `timezone`         | string  |          | `"UTC"`                                    | The timezone to use when filtering meetings using ends\_from and starts\_before (IANA timezone format, e.g., 'America/New\_York'). Defaults to UTC. This property has no effect for non-all-day meetings.                                                                                                                                                        |
| `ends_from`        | string  |          | `"2024-01-01T00:00:00Z"`                   | Use ends\_from to filter meetings to only those that end after the specified timestamp (ISO 8601 format). ends\_from is inclusive, meaning that meetings that end at the exact timestamp will be included in results. When evaluating all-day meetings, we filter results from the perspective of a specific timezone (see timezone parameter).                  |
| `participants`     | string  |          | `"user@example.com,colleague@example.com"` | A comma-separated list of emails to filter meetings by. If provided, meetings will be filtered to only include meetings that include at least one of the provided emails as participants.                                                                                                                                                                        |
| `linked_object`    | string  |          | `"people"`                                 | The object to filter meetings by. Must be a valid object slug or ID (e.g., 'people', 'companies'). If provided, linked\_record\_id must also be provided.                                                                                                                                                                                                        |
| `starts_before`    | string  |          | `"2024-12-31T23:59:59Z"`                   | Use starts\_before to filter meetings to only those that start before the specified timestamp (ISO 8601 format). starts\_before is exclusive, meaning that meetings that start at the exact timestamp will not be included in results. When evaluating all-day meetings, we filter results from the perspective of a specific timezone (see timezone parameter). |
| `linked_record_id` | string  |          | `"92446133-64cf-4f83-bca9-594ca2f8da57"`   | Used to filter meetings to only those values that include a specific linked record. Must be a valid record ID (UUID format). If provided, linked\_object must also be provided.                                                                                                                                                                                  |

***

### `Attio List Notes`

Integration name: **ATTIO\_LIST\_NOTES**

Lists notes in Attio. Can list all notes in the workspace, or filter by parent object type and/or specific record. Notes are returned in reverse chronological order (newest first).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input.

| Parameter          | Type    | Required | Example                                  | Description                                                                                                                                                                                                                |
| ------------------ | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`            | integer |          | —                                        | Maximum number of notes to return. Default is 10, maximum is 50.                                                                                                                                                           |
| `offset`           | integer |          | —                                        | The number of results to skip over before returning. Default is 0.                                                                                                                                                         |
| `parent_object`    | string  |          | `"people"`                               | The slug or ID of the parent object the notes belong to (e.g., 'people', 'companies', 'deals'). If provided, parent\_record\_id must also be specified. If omitted, lists all notes in the workspace.                      |
| `parent_record_id` | string  |          | `"92446133-64cf-4f83-bca9-594ca2f8da57"` | The UUID of the parent record to filter notes by. Must be in UUID format (e.g., '92446133-64cf-4f83-bca9-594ca2f8da57'). If provided, parent\_object must also be specified. If omitted, lists all notes in the workspace. |

***

### `Attio List Objects`

Integration name: **ATTIO\_LIST\_OBJECTS**

This tool retrieves a list of all available objects (both system-defined and user-defined) in the Attio workspace via GET /v2/objects, returning key metadata including slugs and IDs for each object. Call this tool first before ATTIO\_LIST\_RECORDS, ATTIO\_FIND\_RECORD, or ATTIO\_CREATE\_RECORD to discover valid object slugs — hardcoded slugs may not exist across workspaces. Concepts like tasks may be modeled as deals or custom objects rather than dedicated types, so confirm the correct object type before proceeding. Attribute values in responses can be arrays of time-bounded entries rather than simple scalars; downstream code must handle nested structures.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Attio List People Attribute Values`

Integration name: **ATTIO\_LIST\_PEOPLE\_ATTRIBUTE\_VALUES**

Tool to get all values for a given attribute on a person record. Use when you need to retrieve current or historic values for a specific person attribute. Historic values can be queried using the show\_historic param but cannot be queried on COMINT or enriched attributes (returns 400 error).

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                  | Description                                                                                                                        |
| --------------- | ------- | :------: | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `limit`         | integer |          | —                                        | Maximum number of results to return                                                                                                |
| `offset`        | integer |          | —                                        | Number of results to skip                                                                                                          |
| `attribute`     | string  |     ✅    | `"name"`                                 | UUID or slug to identify the attribute                                                                                             |
| `record_id`     | string  |     ✅    | `"00d355cc-7bb2-4fc4-b648-b9516ae45540"` | UUID of the person record to fetch attribute values for                                                                            |
| `show_historic` | boolean |          | —                                        | If true, returns all historic values; defaults to false. Cannot be used with COMINT or enriched attributes (will return 400 error) |

***

### `Attio List People Record Entries`

Integration name: **ATTIO\_LIST\_PEOPLE\_RECORD\_ENTRIES**

Tool to list all entries across all lists for which a person record is the parent in Attio. Use when you need to see which lists a particular person record belongs to. Returns list information and entry IDs for each list the person appears in.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example                                  | Description                                                          |
| ----------- | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------------- |
| `limit`     | integer |          | —                                        | Maximum number of results to return. Default is 100, maximum is 1000 |
| `offset`    | integer |          | —                                        | Number of results to skip over before returning. Default is 0        |
| `record_id` | string  |     ✅    | `"0bdd0060-7a16-4b12-af93-1c3547447d0c"` | A UUID identifying the person record                                 |

***

### `Attio List Record Attribute Values`

Integration name: **ATTIO\_LIST\_RECORD\_ATTRIBUTE\_VALUES**

Tool to retrieve all values for a specified attribute on a record in Attio. Use when you need to see the history of values for a specific attribute. Can return only active values or include historical values. Historic values cannot be queried on COMINT or enriched attributes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                  | Description                                                                    |
| --------------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------ |
| `limit`         | integer |          | —                                        | Maximum results to return                                                      |
| `offset`        | integer |          | —                                        | Number of results to skip before returning                                     |
| `attribute`     | string  |     ✅    | `"email_addresses"`                      | Attribute identifier (UUID or slug)                                            |
| `record_id`     | string  |     ✅    | `"bf071e1f-6035-429d-b874-d83ea64ea13b"` | Record identifier (UUID)                                                       |
| `object_type`   | string  |     ✅    | `"people"`                               | Object identifier (UUID or slug)                                               |
| `show_historic` | boolean |          | —                                        | Returns all historical values when true; returns only active values when false |

***

### `Attio List Records`

Integration name: **ATTIO\_LIST\_RECORDS**

This tool lists records from a specific object type in Attio. It provides simple pagination support and returns records in creation order (oldest first). For complex filtering, use the FindRecord action instead. Standard object types include: people, companies, deals, users, workspaces. If you get a 404 error, verify the object type exists using the List Objects action first. Response attribute values are returned as arrays of time-bounded objects under a `values` map (e.g., `values['name']`), not simple scalars — handle arrays, nested objects, and empty arrays accordingly. Select attributes are accessed via `option.title`; currency, stage, and select fields may be null or empty arrays. Access records via `data.data` in the response.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type    | Required | Example    | Description                                                                                                                                                                                                                                                                                             |
| ------------- | ------- | :------: | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`       | integer |          | —          | Maximum number of records to return Maximum is \~500. Check `has_more` in the response to detect additional pages; increment `offset` by `limit` to retrieve subsequent pages.                                                                                                                          |
| `offset`      | integer |          | —          | Number of records to skip for pagination                                                                                                                                                                                                                                                                |
| `object_type` | string  |     ✅    | `"people"` | The type/slug of object to list records for (also accepts 'object\_id' as an alias). Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'. You can also use custom object types from your workspace. Use the List Objects action to discover all available object types. |

***

### `Attio List Threads`

Integration name: **ATTIO\_LIST\_THREADS**

Tool to list threads of comments on a record or list entry in Attio. Use when you need to view all comment threads associated with a specific record or list entry. Threads contain one or more comments sorted chronologically.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example                                  | Description                                                                                                                                       |
| ----------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list`      | string  |          | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"` | The list (slug or ID) to filter threads by. Must be provided together with 'entry\_id'. Use this to view threads on list entries.                 |
| `limit`     | integer |          | —                                        | Maximum number of threads to return. Default is 10, maximum is 50.                                                                                |
| `object`    | string  |          | `"people"`                               | The object type (slug or ID) to filter threads by. Must be provided together with 'record\_id'. Examples: 'people', 'companies', 'deals'.         |
| `offset`    | integer |          | —                                        | Number of results to skip over before returning. Default is 0. Used for pagination.                                                               |
| `entry_id`  | string  |          | `"2e6e29ea-c4e0-4f44-842d-78a891f8c156"` | UUID of the specific list entry to filter threads by. Must be provided together with 'list'. Use this to view threads on a particular list entry. |
| `record_id` | string  |          | `"891dcbfc-9141-415d-9b2a-2238a6cc012d"` | UUID of the specific record to filter threads by. Must be provided together with 'object'. Use this to view threads on a particular record.       |

***

### `Attio List User Record Entries`

Integration name: **ATTIO\_LIST\_USER\_RECORD\_ENTRIES**

Tool to list all entries across all lists for which a user record is the parent in Attio. Use when you need to see which lists a particular user record belongs to. Returns list information and entry IDs for each list the user appears in.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example                                  | Description                                                          |
| ----------- | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------------- |
| `limit`     | integer |          | —                                        | Maximum number of results to return. Default is 100, maximum is 1000 |
| `offset`    | integer |          | —                                        | Number of results to skip over before returning. Default is 0        |
| `record_id` | string  |     ✅    | `"5e3fb280-007b-495a-a530-9354bde01de1"` | A UUID identifying the user record                                   |

***

### `Attio List User Records`

Integration name: **ATTIO\_LIST\_USER\_RECORDS**

Tool to list user records in Attio with optional filtering and sorting. Use when you need to retrieve workspace members or user records based on specific criteria.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                                           |
| --------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —       | Maximum number of user records to return. Defaults to 500.                                                                                            |
| `sorts`   | array   |          | —       | Array of sort specifications to order results. Each sort object specifies direction ('asc'/'desc'), attribute, and optionally field or path.          |
| `filter`  | object  |          | —       | An object used to filter results to a subset of user records. Supports Attio filter syntax with operators like $eq, $not\_empty, $in, $contains, etc. |
| `offset`  | integer |          | —       | Number of user records to skip for pagination. Defaults to 0.                                                                                         |

***

### `Attio List Webhooks`

Integration name: **ATTIO\_LIST\_WEBHOOKS**

Tool to get all webhooks in your Attio workspace. Use when you need to retrieve a list of configured webhooks, their subscriptions, and statuses. Supports pagination via limit and offset parameters.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                           |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | `10`    | The maximum number of results to return, between 10 and 100, defaults to 10. See the full guide to pagination in Attio documentation. |
| `offset`  | integer |          | `0`     | The number of results to skip over before returning, defaults to 0. See the full guide to pagination in Attio documentation.          |

***

### `Attio List Workspace Members`

Integration name: **ATTIO\_LIST\_WORKSPACE\_MEMBERS**

Tool to list workspace members (actors) so agents can reliably assign owners and resolve workspace-member IDs even when the optional Users standard object is disabled. Use when writing or assigning actor-reference attributes (e.g., record/list entry owners) that require referenced\_actor\_type=workspace-member and an actor id.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

*No parameters required.*

***

### `Attio List Workspace Record Attribute Values`

Integration name: **ATTIO\_LIST\_WORKSPACE\_RECORD\_ATTRIBUTE\_VALUES**

Tool to retrieve all values for a specified attribute on a workspace record in Attio. Use when you need to see the history of values for a specific attribute on a workspace record. Can return only active values or include all historical values sorted chronologically.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type    | Required | Example                                  | Description                                                                                                                    |
| --------------- | ------- | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `limit`         | integer |          | —                                        | Maximum number of results to return for pagination                                                                             |
| `offset`        | integer |          | —                                        | Number of results to skip before returning                                                                                     |
| `attribute`     | string  |     ✅    | `"name"`                                 | The API slug of the attribute (e.g., 'name', 'workspace\_id', 'users', 'company', 'avatar\_url', 'created\_at', 'created\_by') |
| `record_id`     | string  |     ✅    | `"fbe4ce20-f086-40e6-a094-b693aec97862"` | A UUID identifying the workspace record                                                                                        |
| `show_historic` | boolean |          | —                                        | If true, returns all historic values for the attribute. If false, returns only currently active value(s). Defaults to false    |

***

### `Attio List Workspace Record Entries`

Integration name: **ATTIO\_LIST\_WORKSPACE\_RECORD\_ENTRIES**

Tool to list all entries across all lists for which a workspace record is the parent in Attio. Use when you need to see which lists a particular workspace record belongs to. Returns list information and entry IDs for each list the workspace appears in.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type    | Required | Example                                  | Description                                                          |
| ----------- | ------- | :------: | ---------------------------------------- | -------------------------------------------------------------------- |
| `limit`     | integer |          | —                                        | Maximum number of results to return. Default is 100, maximum is 1000 |
| `offset`    | integer |          | —                                        | Number of results to skip over before returning. Default is 0        |
| `record_id` | string  |     ✅    | `"00000000-0000-0000-0000-000000000000"` | A UUID identifying the workspace record                              |

***

### `Attio List Workspace Records`

Integration name: **ATTIO\_LIST\_WORKSPACE\_RECORDS**

Tool to list workspace records with filtering and sorting options. Use when you need to retrieve workspace-level records from Attio. Records are returned based on the filters and sorts provided. Requires record\_permission:read and object\_configuration:read scopes.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                                                                                                                                                       |
| --------- | ------- | :------: | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —       | Maximum number of results to return. Defaults to 500                                                                                                                                                                                                              |
| `sorts`   | array   |          | —       | Array of sort objects to order results by attributes or paths                                                                                                                                                                                                     |
| `filter`  | object  |          | —       | Filter object to subset records. Supports operators like $and, $or, $eq, $ne, $in, $nin, etc. Example: {'$and': \[{'attribute\_slug': {'$eq': 'value'}}, {'another\_slug': {'$ne': 'other'}}]} Refer to Attio's filter syntax documentation for advanced queries. |
| `offset`  | integer |          | —       | Number of results to skip over before returning. Defaults to 0                                                                                                                                                                                                    |

***

### `Attio Patch Record`

Integration name: **ATTIO\_PATCH\_RECORD**

Tool to update people, companies, and other records by record\_id using PATCH method. For multiselect attributes, values supplied will be prepended to existing values. Use PUT endpoint to overwrite or remove multiselect values.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | ------ | :------: | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`    | string |     ✅    | `"people"`                                                                        | A UUID or slug of the object the record belongs to. Standard object types include 'people', 'companies', 'deals'. You can also use custom object slugs from your workspace.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `values`    | object |     ✅    | `{"tags":["Tag1","Tag2"],"status":"Active","description":"Updated via API test"}` | Attribute values keyed by api\_slug or attribute\_id. Single value for single-select, array for multiselect. PATCH behavior: multiselect values are PREPENDED to existing values. Use PUT to overwrite/remove. Type formats: text/number (plain string or number), select/status ('Option Title' string), multiselect (\['Option 1', 'Option 2']), currency {'currency\_value', 'currency\_code'}, date 'YYYY-MM-DD', personal-name {'first\_name', 'last\_name', 'full\_name'}, email {'email\_address'}, phone {'original\_phone\_number', 'country\_code'}, record-reference {'target\_record\_id', 'target\_object'}, domain ('example.com' or {'domain': '...'}). |
| `record_id` | string |     ✅    | `"891dcbfc-9141-415d-9b2a-2238a6cc012d"`                                          | A UUID of the record to update.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

***

### `Attio Patch V2 Lists List Entries Entry Id`

Integration name: **ATTIO\_PATCH\_V2\_LISTS\_LIST\_ENTRIES\_ENTRY\_ID**

Tool to update list entries by entry\_id in Attio. Use when you need to modify attribute values on existing list entries. For multiselect attributes, the values supplied will be created and prepended to existing values. Use the PUT endpoint to overwrite or remove multiselect attribute values.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                                               | Description                                                                                                                                                                                                                                                                                                                         |
| -------------- | ------ | :------: | --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list`         | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"`                                                                              | A UUID or slug of the list the list entry belongs to                                                                                                                                                                                                                                                                                |
| `entry_id`     | string |     ✅    | `"2e6e29ea-c4e0-4f44-842d-78a891f8c156"`                                                                              | A UUID of the list entry to update                                                                                                                                                                                                                                                                                                  |
| `entry_values` | object |     ✅    | `{"multiselect_attribute":["Select option 1","Select option 2"],"41252299-f8c7-4b5e-99c9-4ff8321d2f96":"Text value"}` | An object with an attribute `api_slug` or attribute\_id as the key, and a single value (for single-select attributes), or an array of values (for single or multi-select attributes) as the values. For multiselect attributes, the values supplied will be created and prepended to the list of values that already exist (if any) |

***

### `Attio People Get Person`

Integration name: **ATTIO\_PEOPLE\_GET\_PERSON**

Tool to get a single person record by its record\_id in Attio. Use when you need to retrieve detailed information about a specific person. Returns all attribute values for the person with temporal and audit metadata.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                  | Description                                    |
| ----------- | ------ | :------: | ---------------------------------------- | ---------------------------------------------- |
| `record_id` | string |     ✅    | `"00d355cc-7bb2-4fc4-b648-b9516ae45540"` | UUID identifying the person record to retrieve |

***

### `Attio People List Persons`

Integration name: **ATTIO\_PEOPLE\_LIST\_PERSONS**

Tool to list person records from Attio with optional filtering and sorting. Use when you need to retrieve people based on specific criteria or get a paginated list of all people.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`   | integer |          | —       | Maximum number of records to return. Defaults to 500.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `sorts`   | array   |          | —       | Array of sort specifications to order results. Each sort object specifies direction ('asc'/'desc'), attribute, and optionally field or path.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `filter`  | object  |          | —       | Attio filter object for server-side filtering. Supports shorthand and verbose syntax. IMPORTANT: Filter by attribute slugs (e.g., 'name', 'email\_addresses'), NOT sub-properties directly. Multi-field attributes like 'name' have sub-properties (first\_name, last\_name, full\_name) accessed via nested syntax: {'name': {'first\_name': {'$eq': 'John'}}}. Do NOT use {'first\_name': 'John'} - first\_name is not a top-level attribute. CRITICAL: All operators must include the '$' prefix (e.g., $eq, NOT 'eq'). OPERATOR SUPPORT BY ATTRIBUTE TYPE: - Text: $eq, $not\_empty, $in, $contains, $starts\_with, $ends\_with, $and, $or, $not - Email-address sub-properties (email\_address, email\_domain, etc.): $eq, $contains, $starts\_with, $ends\_with. Note: $not\_empty is NOT supported for email-address sub-properties. - Personal-name sub-properties: $eq and string operators on first\_name, last\_name, full\_name - Numeric/Date: $eq, $not\_empty, $in, $lt, $lte, $gt, $gte, $and, $or, $not Examples: {'name': 'John'} for shorthand, {'name': {'last\_name': {'$contains': 'Smith'}}} for nested, {'email\_addresses': {'email\_address': {'$eq': '<user@example.com>'}}} for exact email match. |
| `offset`  | integer |          | —       | Number of records to skip for pagination. Defaults to 0.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

***

### `Attio Post V2 Lists List Entries`

Integration name: **ATTIO\_POST\_V2\_LISTS\_LIST\_ENTRIES**

Tool to add a record to a list as a new list entry in Attio. Use when you need to organize records into specific lists. This endpoint will throw on conflicts of unique attributes. Multiple list entries are allowed for the same parent record.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                                                                                                               | Description                                                                                                                                                                                                                                                                                              |
| ------------------ | ------ | :------: | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list`             | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"`                                                                              | The UUID or slug identifying the list that the created list entry should belong to                                                                                                                                                                                                                       |
| `entry_values`     | object |          | `{"multiselect_attribute":["Select option 1","Select option 2"],"41252299-f8c7-4b5e-99c9-4ff8321d2f96":"Text value"}` | An object with an attribute `api_slug` or attribute\_id as the key, and a single value (for single-select attributes), or an array of values (for single or multi-select attributes) as the values. For complete documentation on values for all attribute types, please see Attio's attribute type docs |
| `parent_object`    | string |     ✅    | `"people"`                                                                                                            | A UUID or slug identifying the object that the added parent record belongs to                                                                                                                                                                                                                            |
| `parent_record_id` | string |     ✅    | `"891dcbfc-9141-415d-9b2a-2238a6cc012d"`                                                                              | A UUID identifying the record you want to add to the list. The record will become the 'parent' of the created list entry                                                                                                                                                                                 |

***

### `Attio Post V2 Lists List Entries Query`

Integration name: **ATTIO\_POST\_V2\_LISTS\_LIST\_ENTRIES\_QUERY**

Tool to list entries in a given list, with the option to filter and sort results. Use when you need to retrieve records that belong to a specific list with optional filtering and sorting.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------- | ------- | :------: | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list`    | string  |     ✅    | `"people-list"` | A UUID or slug identifying the list to retrieve entries from                                                                                                                                                                                                                                                                                                                                                                                    |
| `limit`   | integer |          | —               | The maximum number of results to return. Defaults to 500.                                                                                                                                                                                                                                                                                                                                                                                       |
| `sorts`   | array   |          | —               | An array of sort objects used to sort results. Each descriptor must contain direction ('asc' or 'desc') and either attribute or path.                                                                                                                                                                                                                                                                                                           |
| `filter`  | object  |          | —               | Filter object using list-specific attribute slugs (NOT parent object attributes). Use ATTIO\_LIST\_ATTRIBUTES with target='lists' to discover valid attribute slugs for this list. Supports shorthand syntax (e.g., {'attribute\_slug': 'value'}) for simple equality or verbose syntax with operators like $eq, $not\_empty, $in, $contains, $lt, $gt. See <https://docs.attio.com/rest-api/how-to/filtering-and-sorting> for complete syntax. |
| `offset`  | integer |          | —               | The number of results to skip over before returning. Defaults to 0.                                                                                                                                                                                                                                                                                                                                                                             |

***

### `Attio Post V2 Objects Object Records`

Integration name: **ATTIO\_POST\_V2\_OBJECTS\_OBJECT\_RECORDS**

DEPRECATED: Use ATTIO\_CREATE\_RECORD instead. Creates a new person, company or other record. This endpoint will throw on conflicts of unique attributes. If you would prefer to update records on conflicts, please use the Assert record endpoint instead.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                                                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------- | ------ | :------: | ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`  | string |     ✅    | `"people"`                                                                                                                           | The UUID or slug identifying the object the created record should belong to.                                                                                                                                                                                                                                                                                                                                                                                                       |
| `values`  | object |     ✅    | `{"name":[{"full_name":"John Doe","last_name":"Doe","first_name":"John"}],"email_addresses":[{"email_address":"john@example.com"}]}` | An object with an attribute `api_slug` or attribute\_id as the key, and a single value (for single-select attributes), or an array of values (for single or multi-select attributes) as the values. For complete documentation on values for all attribute types, please see the Attio attribute type documentation. Example: {'name': \[{'first\_name': 'John', 'last\_name': 'Doe', 'full\_name': 'John Doe'}], 'email\_addresses': \[{'email\_address': '<john@example.com>'}]} |

***

### `Attio Post V2 Objects Object Records Query`

Integration name: **ATTIO\_POST\_V2\_OBJECTS\_OBJECT\_RECORDS\_QUERY**

Tool to list people, company or other records in Attio with the option to filter and sort results. Use when you need to retrieve records based on complex filter criteria or sorting requirements.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------- | ------- | :------: | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —          | Maximum number of records to return. Common values up to 500.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `sorts`   | array   |          | —          | Array of sort specifications to order results. Each sort object specifies direction ('asc'/'desc'), attribute, and optionally field or path. IMPORTANT: 'updated\_at' is NOT a valid attribute - use 'created\_at' or call List Attributes to discover valid sortable attributes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `filter`  | object  |          | —          | Attio filter object. Supports shorthand, verbose, and path-based filtering. IMPORTANT: Filter by attribute slugs (e.g., 'name', 'email\_addresses'), NOT sub-properties directly. Use ATTIO\_LIST\_ATTRIBUTES to discover correct slugs - names may differ from display titles (e.g., 'company' not 'companies'). Multi-field attributes like 'name' have sub-properties (first\_name, last\_name, full\_name) accessed via nested syntax: {'name': {'first\_name': {'$eq': 'John'}}}. Do NOT use {'first\_name': 'John'} - first\_name is not a top-level attribute. TIMESTAMP/DATE: 'created\_at' is the standard timestamp attribute. CRITICAL: 'updated\_at' is NOT valid in Attio. Use $eq/$gt/$gte/$lt/$lte on timestamp attributes: {'created\_at': {'$gte': '2024-01-01T00:00:00.000Z'}}. INTERACTION ATTRIBUTES (e.g., 'last\_email\_interaction'): Properties: owner\_member\_id ($eq/$not\_empty), interacted\_at ($eq/$gte/$gt/$lte/$lt - requires ISO8601, NOT $not\_empty), interaction\_type ($eq/$not\_empty). RECORD-REFERENCE: Use attribute slug with target\_object and target\_record\_id: {'company': {'target\_object': 'companies', 'target\_record\_id': 'id'}}. Use singular slug (e.g., 'company' not 'companies'). PATH-BASED FILTERING: {'path': \[\[object\_slug, attribute\_slug], ...], 'constraints': {property: value}}. Path is an array of \[object\_slug, attribute\_slug] pairs; constraints apply to the final attribute. Operators: $eq, $not\_empty, $in, $contains, $starts\_with, $ends\_with, $lt/$lte/$gt/$gte, $and/$or/$not. CRITICAL: All operators MUST include the $ prefix (use $gte, NOT gte). |
| `object`  | string  |     ✅    | `"people"` | The object slug or UUID to query records from (e.g., 'people', 'companies', or custom object UUID). Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `offset`  | integer |          | —          | Number of records to skip for pagination                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

***

### `Attio Post V2 Objects Records Search`

Integration name: **ATTIO\_POST\_V2\_OBJECTS\_RECORDS\_SEARCH**

DEPRECATED: Use ATTIO\_SEARCH\_RECORDS instead. Tool to fuzzy search for records across one or more objects in Attio. Use when you need to find records by name, domain, email, phone number, or social handle. This endpoint is in beta and returns eventually consistent results. For results guaranteed to be up to date, use the record query endpoint instead.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example         | Description                                                                                                                                                                                                                   |
| ------------ | ------- | :------: | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | —               | Maximum number of results to return. Defaults to 25. Range: 1-25.                                                                                                                                                             |
| `query`      | string  |     ✅    | `"alan mathis"` | Query string to search for (max 256 characters). An empty string returns a default set of results. Matches names, domains, emails, phone numbers and social handles on people and companies, and labels on all other objects. |
| `objects`    | array   |     ✅    | `["people"]`    | Specifies which objects to filter results by. At least one object must be specified. Accepts object slugs or IDs.                                                                                                             |
| `request_as` | —       |     ✅    | —               | Specifies the context in which to perform the search. Use 'workspace' to return all search results or specify a workspace member to limit results to what one specific person in your workspace can see.                      |

***

### `Attio Put V2 Lists List Entries`

Integration name: **ATTIO\_PUT\_V2\_LISTS\_LIST\_ENTRIES**

Tool to create or update a list entry for a given parent record in Attio. If an entry with the specified parent record is found, that entry will be updated. If no such entry is found, a new entry will be created instead. For multiselect attributes, all values will be either created or deleted as necessary to match the list of values supplied in the request.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter          | Type   | Required | Example                                                                                                               | Description                                                                                                                                                                                                                                                                                                                    |
| ------------------ | ------ | :------: | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `list`             | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"`                                                                              | A UUID or slug of the list the list entry belongs to.                                                                                                                                                                                                                                                                          |
| `entry_values`     | object |          | `{"multiselect_attribute":["Select option 1","Select option 2"],"41252299-f8c7-4b5e-99c9-4ff8321d2f96":"Text value"}` | An object with an attribute api\_slug or attribute\_id as the key, and a single value (for single-select attributes), or an array of values (for single or multi-select attributes) as the values. For multiselect attributes, all values will be either created or deleted as necessary to match the list of values supplied. |
| `parent_object`    | string |     ✅    | `"people"`                                                                                                            | A UUID or slug identifying the object that the added parent record belongs to.                                                                                                                                                                                                                                                 |
| `parent_record_id` | string |     ✅    | `"891dcbfc-9141-415d-9b2a-2238a6cc012d"`                                                                              | A UUID identifying the record you want to add to the list. The record will become the 'parent' of the created list entry.                                                                                                                                                                                                      |

***

### `Attio Put V2 Lists List Entries Entry Id`

Integration name: **ATTIO\_PUT\_V2\_LISTS\_LIST\_ENTRIES\_ENTRY\_ID**

Tool to update list entries by entry\_id in Attio using PUT method. Use when you need to completely replace attribute values on existing list entries. For multiselect attributes, the values supplied will overwrite/remove the list of values that already exist (if any). Use the PATCH endpoint to add multiselect attribute values without removing those that already exist.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                                                                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------- | ------ | :------: | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list`         | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"`                                                                              | A UUID or slug of the list the list entry belongs to                                                                                                                                                                                                                                                                                                                                                                            |
| `entry_id`     | string |     ✅    | `"2e6e29ea-c4e0-4f44-842d-78a891f8c156"`                                                                              | A UUID of the list entry to update                                                                                                                                                                                                                                                                                                                                                                                              |
| `entry_values` | object |     ✅    | `{"multiselect_attribute":["Select option 1","Select option 2"],"41252299-f8c7-4b5e-99c9-4ff8321d2f96":"Text value"}` | An object with an attribute `api_slug` or attribute\_id as the key, and a single value (for single-select attributes), or an array of values (for single or multi-select attributes) as the values. For multiselect attributes, the values supplied will overwrite/remove the list of values that already exist (if any). Use the PATCH endpoint to add multiselect attribute values without removing those that already exist. |

***

### `Attio Put V2 Objects Object Records`

Integration name: **ATTIO\_PUT\_V2\_OBJECTS\_OBJECT\_RECORDS**

Tool to create or update people, companies and other records in Attio using a matching attribute. Use when you want to avoid duplicate records - if a record with the same value for the matching attribute is found, it will be updated; otherwise a new record is created. If you want to avoid matching and always create new records, use the Create Record endpoint instead.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter            | Type   | Required | Example                                                                                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------- | ------ | :------: | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`             | string |     ✅    | `"people"`                                                                                                            | A UUID or slug to identify the object the record should belong to. Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'. You can also use custom object types from your workspace.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `values`             | object |     ✅    | `{"multiselect_attribute":["Select option 1","Select option 2"],"41252299-f8c7-4b5e-99c9-4ff8321d2f96":"Text value"}` | An object with an attribute api\_slug or attribute\_id as the key, and a single value (for single-select attributes), or an array of values (for single or multi-select attributes) as the values. For complete documentation on values for all attribute types, please see Attio's attribute type docs. Examples of value formats by attribute type: TEXT/NUMBER: 'Text value' or 123, EMAIL: \[{'email\_address': '<test@example.com>'}], PERSONAL-NAME: \[{'first\_name': 'Test', 'last\_name': 'User', 'full\_name': 'Test User'}], DOMAIN: \[{'domain': 'example.com'}], SELECT: \['Select option 1', 'Select option 2'], RECORD-REFERENCE: \[{'target\_object': 'people', 'target\_record\_id': 'uuid'}] |
| `matching_attribute` | string |     ✅    | `"email_addresses"`                                                                                                   | The ID or slug of the attribute to use to check if a record already exists. The attribute must be unique. If a record is found with the same value for the matching attribute, that record will be updated. If no record with the same value for the matching attribute is found, a new record will be created instead. IMPORTANT: For multiselect matching attributes, new values will be added and existing values will not be deleted. For any other multiselect attribute, all values will be either created or deleted as necessary to match the list of supplied values.                                                                                                                                 |

***

### `Attio Put V2 Objects Object Records Record Id`

Integration name: **ATTIO\_PUT\_V2\_OBJECTS\_OBJECT\_RECORDS\_RECORD\_ID**

Tool to update people, companies, and other records by record\_id using PUT method. For multiselect attributes, values supplied will overwrite/remove existing values. Use PATCH endpoint to append without removing.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | ------ | :------: | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`    | string |     ✅    | `"people"`                                                                        | A UUID or slug of the object the record belongs to. Standard object types include 'people', 'companies', 'deals'. You can also use custom object slugs from your workspace.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `values`    | object |     ✅    | `{"tags":["Tag1","Tag2"],"status":"Active","description":"Updated via API test"}` | Attribute values keyed by api\_slug or attribute\_id. Single value for single-select, array for multiselect. PUT behavior: multiselect values OVERWRITE/REMOVE existing values. Use PATCH endpoint to append without removing. Type formats: text/number (plain string or number), select/status ('Option Title' string), multiselect (\['Option 1', 'Option 2']), currency {'currency\_value', 'currency\_code'}, date 'YYYY-MM-DD', personal-name {'first\_name', 'last\_name', 'full\_name'}, email {'email\_address'}, phone {'original\_phone\_number', 'country\_code'}, record-reference {'target\_record\_id', 'target\_object'}, domain ('example.com' or {'domain': '...'}). |
| `record_id` | string |     ✅    | `"891dcbfc-9141-415d-9b2a-2238a6cc012d"`                                          | A UUID of the record to update.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

***

### `Attio Query Records`

Integration name: **ATTIO\_QUERY\_RECORDS**

Tool to query records for a specific Attio object using server-side filtering operators and sorting. Use when you need to retrieve records based on complex filter criteria (e.g., 'get all agreements where product=X and status in Y') rather than simple listing or ID-based lookup. This avoids downloading large pages and filtering locally, which is slow and costly.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type    | Required | Example    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------- | ------- | :------: | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`   | integer |          | —          | Maximum number of records to return. Common values up to 500.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `sorts`   | array   |          | —          | Array of sort specifications to order results. Each sort object specifies direction ('asc'/'desc'), attribute, and optionally field or path.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `filter`  | object  |          | —          | Attio filter object for server-side filtering. IMPORTANT: Always filter by attribute slugs (e.g., 'name', 'email\_addresses'), NEVER by sub-properties directly at the top level. TIMESTAMP FILTERS: All timestamp comparisons MUST use ISO8601 string format (e.g., '2024-01-01T00:00:00.000Z'). Example: {'created\_at': {'$gte': '2024-01-01T00:00:00.000Z'}}. PERSONAL-NAME: 'name' sub-properties (first\_name, last\_name, full\_name) MUST be nested under 'name'. Correct: {'name': {'first\_name': {'$contains': 'John'}, 'last\_name': {'$contains': 'Smith'}}}. WRONG: {'first\_name': {...}} - fails with 'unknown\_filter\_attribute\_slug'. Shorthand: {'name': 'John Smith'}. EMAIL: email\_addresses supports $eq, $contains, $starts\_with, $ends\_with (NOT $not\_empty). INTERACTION (e.g., 'last\_email\_interaction'): Properties: owner\_member\_id ($eq/$not\_empty), interacted\_at ($eq/$gte/$gt/$lte/$lt with ISO8601), interaction\_type ($eq/$not\_empty). RECORD-REFERENCE: {'company': {'target\_object': 'companies', 'target\_record\_id': ''}}. Multiple: {'company': {'target\_object': 'companies', 'target\_record\_id': {'$in': \['', '']}}}. Path-based: {'path': \[\['companies', 'team'], \['people', 'name']], 'constraints': {'first\_name': {'$eq': 'John'}}}. OPERATORS: $eq, $not\_empty (varies by type), $in, $contains, $starts\_with, $ends\_with, $lt/$lte/$gt/$gte, $and/$or/$not. |
| `object`  | string  |     ✅    | `"people"` | The object slug or UUID to query records from (e.g., 'people', 'companies', or custom object UUID). Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `offset`  | integer |          | —          | Number of records to skip for pagination                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

***

### `Attio Search Records`

Integration name: **ATTIO\_SEARCH\_RECORDS**

Tool to fuzzy search for records across multiple objects in Attio. Use when you need to find records by name, domain, email, phone number, or social handle. This endpoint is in beta and returns eventually consistent results. Matching strategy follows the in-product search approach.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type    | Required | Example         | Description                                                                                                      |
| ------------ | ------- | :------: | --------------- | ---------------------------------------------------------------------------------------------------------------- |
| `limit`      | integer |          | —               | Maximum number of results to return. Range: 1-25                                                                 |
| `query`      | string  |     ✅    | `"alan mathis"` | Query string to search for. An empty string returns a default set of results. Maximum 256 characters             |
| `objects`    | array   |     ✅    | `["people"]`    | Specifies which objects to filter results by. At least one object must be specified. Accepts object slugs or IDs |
| `request_as` | —       |     ✅    | —               | Specifies the context for the search request. Can be workspace or workspace-member                               |

***

### `Attio Update Attribute`

Integration name: **ATTIO\_UPDATE\_ATTRIBUTE**

Tool to update an existing attribute by its attribute\_id or slug. Use when you need to modify attribute properties such as title, description, validation rules, or configuration settings.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                  | Description                                                                                                                                                                                        |
| ------------ | ------ | :------: | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`       | object |     ✅    | —                                        | The data object containing the attribute fields to update. At least one field (title, description, api\_slug, is\_required, is\_unique, default\_value, config, or is\_archived) must be provided. |
| `target`     | string |     ✅    | `"objects"`                              | Whether the attribute is on an object or a list.                                                                                                                                                   |
| `attribute`  | string |     ✅    | `"41252299-f8c7-4b5e-99c9-4ff8321d2f96"` | A UUID or slug to identify the attribute.                                                                                                                                                          |
| `identifier` | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"` | A UUID or slug to identify the object or list the attribute belongs to.                                                                                                                            |

***

### `Attio Update Company`

Integration name: **ATTIO\_UPDATE\_COMPANY**

Tool to update a company record in Attio by its record\_id. Use when you need to modify company attributes like name, description, domains, or team. For multiselect attributes, values are prepended to existing values. Note: logo\_url cannot be updated via API.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                                                                                                                                                                                                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------- | ------ | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `values`    | object |     ✅    | `{"name":[{"value":"Updated Company Name"}],"domains":[{"domain":"newdomain.com"}],"description":[{"value":"Updated company description via API test"}],"primary_location":["1 Infinite Loop, Cupertino, CA, 95014, US"]}` | Attribute values to update on the company record. Keys are attribute slugs; values are arrays of value objects. Type formats: text/number {'value': x}, currency {'currency\_value', 'currency\_code'}, date {'value': 'YYYY-MM-DD'}, domain {'domain': '...'} (do NOT include 'root\_domain'), select/status {'option': 'Title'} (must match workspace options; use List Attributes to discover), email {'email\_address': '...'}, phone {'original\_phone\_number', 'country\_code'}, record-reference {'target\_record\_id', 'target\_object'}, location (address string or object). For multiselect, values are prepended (not replaced). logo\_url cannot be updated via API. |
| `record_id` | string |     ✅    | `"0059945e-fdff-4ae1-a200-5995bdfd7831"`                                                                                                                                                                                   | The UUID identifying the company record to update                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

***

### `Attio Update Deal Record`

Integration name: **ATTIO\_UPDATE\_DEAL\_RECORD**

Tool to update an existing deal record in Attio by record ID. Uses PATCH to partially update only the provided fields, leaving other fields unchanged.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                                                                                                                                                                                                                                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------- | ------ | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `values`    | object |     ✅    | `{"name":["Updated Deal Name - Test Successful"],"owner":["user@example.com"],"stage":["In Progress"],"value":[{"currency_value":5000}],"associated_company":[{"target_object":"companies","target_record_id":"92446133-64cf-4f83-bca9-594ca2f8da57"}]}` | Attribute values to update on the deal record. Keys are attribute slugs; values are arrays. Type formats: text/number use plain strings, currency {'currency\_value': N}, select/status use plain string (recommended) or {'option'/'status': 'Title'}, actor-reference use email string or {'workspace\_member\_email\_address': '...'} (use ATTIO\_LIST\_WORKSPACE\_MEMBERS for valid emails), record-reference {'target\_object': '...', 'target\_record\_id': 'uuid'}. Auto-correction: {'value': '...'} is auto-converted to a plain string. |
| `record_id` | string |     ✅    | `"edc68d6a-d682-4d29-8e21-328983291ef0"`                                                                                                                                                                                                                 | A UUID of the deal record to update                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

***

### `Attio Update Entry`

Integration name: **ATTIO\_UPDATE\_ENTRY**

DEPRECATED: Use ATTIO\_ATTIO\_PATCH\_V2\_LISTS\_LIST\_ENTRIES\_ENTRY\_ID instead. Tool to update list entries by their ID in Attio. Use when you need to modify attribute values on existing list entries. When multiselect attributes are included, the values supplied will be prepended to existing values.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter      | Type   | Required | Example                                  | Description                                                                                                                                         |
| -------------- | ------ | :------: | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_id`      | string |     ✅    | `"enterprise_sales"`                     | A UUID or slug identifying the list containing the entry                                                                                            |
| `entry_id`     | string |     ✅    | `"2e6e29ea-c4e0-4f44-842d-78a891f8c156"` | A UUID identifying the specific list entry to update                                                                                                |
| `entry_values` | object |     ✅    | —                                        | Attribute values to update. Field values organized by attribute slug or ID. For multiselect attributes, values will be prepended to existing values |

***

### `Attio Update List`

Integration name: **ATTIO\_UPDATE\_LIST**

Tool to update an existing list in Attio. Use when you need to modify list properties like name, api\_slug, or permissions. Lists must have either workspace\_access set to 'full-access' or one or more workspace\_member\_access with 'full-access' level. Changing the parent object of a list is not possible through the API.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter                 | Type   | Required | Example                                                                                  | Description                                                                                                                                                                                                                                                                                              |
| ------------------------- | ------ | :------: | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list`                    | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"`                                                 | A UUID or slug to identify the list to update                                                                                                                                                                                                                                                            |
| `name`                    | string |          | `"Enterprise Sales"`                                                                     | The human-readable name of the list                                                                                                                                                                                                                                                                      |
| `api_slug`                | string |          | `"enterprise_sales"`                                                                     | A unique, human-readable slug to access the list through API calls. Should be formatted in snake case                                                                                                                                                                                                    |
| `workspace_access`        | string |          | `"read-and-write"`                                                                       | The level of access granted to all members of the workspace for this list. Pass null to keep the list private and only grant access to specific workspace members. Note: Lists must have either workspace\_access set to 'full-access' or one or more workspace\_member\_access with 'full-access' level |
| `workspace_member_access` | array  |          | `[{"level":"full-access","workspace_member_id":"50cf242c-7fa3-4cad-87d0-75b1af71c57b"}]` | The level of access granted to specific workspace members for this list. Pass an empty array to grant access to no workspace members. Note: Lists must have either workspace\_access set to 'full-access' or one or more workspace\_member\_access with 'full-access' level                              |

***

### `Attio Update Object`

Integration name: **ATTIO\_UPDATE\_OBJECT**

Tool to update a single object's configuration in Attio. Use when you need to modify an object's API slug, singular noun, or plural noun. Standard objects (people, companies, deals, users, workspaces) and custom objects can be updated.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example    | Description                                                                                                                                                                                     |
| ----------- | ------ | :------: | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `data`      | object |     ✅    | —          | The object data to update. Provide at least one of api\_slug, singular\_noun, or plural\_noun.                                                                                                  |
| `object_id` | string |     ✅    | `"people"` | A UUID or slug to identify the object to update. Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'. You can also use custom object types from your workspace. |

***

### `Attio Update Person`

Integration name: **ATTIO\_UPDATE\_PERSON**

Tool to update a person record in Attio by its record\_id. Use when you need to modify person attributes like name, email, job title, or phone numbers. For multiselect attributes, values are prepended to existing values. Note: avatar\_url cannot be updated via API.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                                                                                                                                                                                                                                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------- | ------ | :------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `values`    | object |     ✅    | `{"name":[{"full_name":"John Doe","last_name":"Doe","first_name":"John"}],"job_title":[{"value":"Senior Software Engineer"}],"description":[{"value":"Updated person description via API"}],"email_addresses":[{"email_address":"john.doe@example.com"}]}` | Attribute values to update on the person record. Keys are attribute slugs; values are arrays of value objects. Type formats: text/number {'value': x}, personal-name {'first\_name', 'last\_name', 'full\_name'}, email {'email\_address': '...'}, phone {'original\_phone\_number', 'country\_code'}, currency {'currency\_value', 'currency\_code'}, date {'value': 'YYYY-MM-DD'}, select/status {'option': 'Title'} (must match workspace options; use List Attributes to discover), record-reference {'target\_record\_id', 'target\_object'}, location (address string or object). For multiselect, values are prepended (not replaced); use Assert Person to overwrite. avatar\_url cannot be updated via API. |
| `record_id` | string |     ✅    | `"00d355cc-7bb2-4fc4-b648-b9516ae45540"`                                                                                                                                                                                                                   | The UUID identifying the person record to update                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

***

### `Attio Update Record`

Integration name: **ATTIO\_UPDATE\_RECORD**

This tool updates an existing record in Attio for a specified object type (people, companies, deals, users, workspaces, etc.). It uses PATCH to partially update only the provided fields, leaving other fields unchanged.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter     | Type   | Required | Example                                                                                                                                                                                                                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------- | ------ | :------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `values`      | object |     ✅    | `{"name":[{"full_name":"Jane Smith","last_name":"Smith","first_name":"Jane"}],"owner":["user@example.com"],"stage":["Active"],"job_title":["Senior Developer"],"categories":["Technology"],"credits_bought":[{"currency_value":1400}]}` | Attribute values to update on the record. Keys are attribute slugs; values are arrays. Type formats: text/number/date use plain strings, currency {'currency\_value': N}, select/status use plain string (recommended) or {'option'/'status': 'Title'}, personal-name {'first\_name', 'last\_name', 'full\_name'}, email {'email\_address': '...'}, phone {'original\_phone\_number', 'country\_code'}, actor-reference use email string or {'workspace\_member\_email\_address': '...'} (use ATTIO\_LIST\_WORKSPACE\_MEMBERS for valid emails), record-reference {'target\_object': '...', 'target\_record\_id': 'uuid'}. Auto-correction: {'value': '...'} is auto-converted to a plain string. |
| `record_id`   | string |     ✅    | `"92446133-64cf-4f83-bca9-594ca2f8da57"`                                                                                                                                                                                                | The unique identifier of the record to update                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `object_type` | string |     ✅    | `"people"`                                                                                                                                                                                                                              | The type of object to update. Standard object types include 'people', 'companies', 'deals', 'users', 'workspaces'. You can also use custom object types from your workspace.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

***

### `Attio Update Select Option`

Integration name: **ATTIO\_UPDATE\_SELECT\_OPTION**

Tool to update an existing select option for a select or multiselect attribute in Attio. Use when you need to rename an option or archive it. Archived options are hidden from selection but preserve historical data for records that used them.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example       | Description                                                                   |
| ------------ | ------ | :------: | ------------- | ----------------------------------------------------------------------------- |
| `data`       | object |     ✅    | —             | The fields to update on the select option                                     |
| `option`     | string |     ✅    | `"Medium"`    | A UUID or select option title to identify the select option to update         |
| `target`     | string |     ✅    | `"objects"`   | Whether the attribute is on an object or a list.                              |
| `attribute`  | string |     ✅    | `"priority"`  | A UUID or slug to identify the select or multiselect attribute                |
| `identifier` | string |     ✅    | `"companies"` | A UUID or slug to identify the object or list the select attribute belongs to |

***

### `Attio Update Status`

Integration name: **ATTIO\_UPDATE\_STATUS**

Tool to update a status on a status attribute on either an object or a list in Attio. Use when you need to modify status properties like title, celebration settings, target time, or archive status. Company and person objects do not support status attributes at this time.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter    | Type   | Required | Example                                  | Description                                                                                                                          |
| ------------ | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `data`       | object |     ✅    | —                                        | The status data to update. At least one field must be provided.                                                                      |
| `status`     | string |     ✅    | `"e842b1d9-cd15-4d8a-9c93-8fd9c42071ac"` | A UUID or status title to identify the status to update                                                                              |
| `target`     | string |     ✅    | `"lists"`                                | Whether the attribute is on an object or a list. Note that company and person objects do not support status attributes at this time. |
| `attribute`  | string |     ✅    | `"41252299-f8c7-4b5e-99c9-4ff8321d2f96"` | A UUID or slug to identify the attribute to update the status on                                                                     |
| `identifier` | string |     ✅    | `"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"` | A UUID or slug to identify the object or list the status attribute belongs to                                                        |

***

### `Attio Update Task`

Integration name: **ATTIO\_UPDATE\_TASK**

Tool to update an existing task in Attio by its task\_id. Use when you need to modify a task's deadline, completion status, linked records, or assignees. Only these four fields can be updated via this endpoint.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter | Type   | Required | Example                                  | Description                                                                                            |
| --------- | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `data`    | object |     ✅    | —                                        | The fields to update. Only deadline\_at, is\_completed, linked\_records, and assignees can be updated. |
| `task_id` | string |     ✅    | `"649e34f4-c39a-4f4d-99ef-48a36bef8f04"` | The ID of the task to update.                                                                          |

***

### `Attio Update User Record`

Integration name: **ATTIO\_UPDATE\_USER\_RECORD**

Tool to update a user record in Attio by its record\_id. Use when you need to modify user attributes like user\_id, primary\_email\_address, person, or workspace references. Attributes not included in the request will remain unchanged.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                                                                                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------- | ------ | :------: | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `values`    | object |     ✅    | `{"user_id":[{"value":"updated_user_456"}],"primary_email_address":[{"email_address":"user@example.com"}]}` | The attribute values to update on the user record. Each key is an attribute slug, and values are arrays of attribute value objects. Attributes that are not included in the request body will not be changed. Common user attributes include: user\_id, primary\_email\_address, person, workspace. Different attribute types require different value structures: (1) Text fields (e.g., user\_id): use \[{'value': 'text'}]. (2) Email fields (e.g., primary\_email\_address): use \[{'email\_address': '<user@example.com>'}]. (3) Record-reference fields (e.g., person, workspace): use \[{'target\_record\_id': 'uuid', 'target\_object': 'people'}]. |
| `record_id` | string |     ✅    | `"2c2dd684-f22f-4e2d-9dce-3077bb15a557"`                                                                    | The ID of the user record to update                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

***

### `Attio Update Webhook`

Integration name: **ATTIO\_UPDATE\_WEBHOOK**

Tool to update a webhook's target URL and/or event subscriptions. Use when you need to modify an existing webhook configuration in Attio.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter       | Type   | Required | Example                                  | Description                                                                                                               |
| --------------- | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `target_url`    | string |          | `"https://example.com/webhook"`          | URL where the webhook events will be delivered to. Must be an HTTPS URL.                                                  |
| `webhook_id`    | string |     ✅    | `"23e42eaf-323a-41da-b5bb-fd67eebda553"` | A UUID which identifies the webhook.                                                                                      |
| `subscriptions` | array  |          | —                                        | One or more events the webhook is subscribed to. Each subscription contains an event type and optional filter conditions. |

***

### `Attio Update Workspace Record`

Integration name: **ATTIO\_UPDATE\_WORKSPACE\_RECORD**

Tool to update a workspace record by ID using PATCH method. Only the attributes provided in the request will be updated; other attributes remain unchanged.

#### Parameters

Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.

| Parameter   | Type   | Required | Example                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------- | ------ | :------: | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `values`    | object |     ✅    | `{"name":[{"value":"Updated Workspace Name"}]}` | The attribute values to update on the workspace record. Only the attributes included will be updated; other attributes will remain unchanged. Common workspace attributes include: (1) 'name': workspace name as a text field, e.g., {"name": \[{"value": "Updated Workspace Name"}]}. (2) 'workspace\_id': workspace identifier. (3) 'users': record references to user records. (4) 'company': record reference to a company record. (5) 'avatar\_url': URL to workspace avatar image. Each attribute requires an array of value objects with attribute-type-specific fields. |
| `record_id` | string |     ✅    | `"c200d84d-67a2-5f8e-9ec3-8c8dec0cb221"`        | The UUID of the workspace record to update                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

***


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/integrations/attio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
