> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heyhumm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Attio

> Connect to Attio CRM for contact management and deal tracking.

Humm queries your Attio people, companies, and deals. Ask about pipeline, contact activity, or filter your CRM data with Attio's flexible query syntax.

## Source Types

<CardGroup cols={2}>
  <Card title="SaaS (Live)" icon="bolt">
    Humm queries the Attio API directly in real time. Data is never stored by Humm.
  </Card>

  <Card title="Sync" icon="arrows-rotate">
    Humm syncs your Attio data into your warehouse via Airbyte, then queries the copy. Better performance and lets you join CRM data with everything else in your warehouse.
  </Card>
</CardGroup>

See [Choosing a Source Type](/integrations/overview#choosing-a-source-type) for help deciding.

## Tools

| Tool                           | Description                                                                           |
| ------------------------------ | ------------------------------------------------------------------------------------- |
| `ATTIO_LIST_RECORDS`           | List records for an object type (people, companies, deals) with filtering and sorting |
| `ATTIO_READ_RECORD`            | Get a record by ID and object type                                                    |
| `ATTIO_LIST_WORKSPACE_MEMBERS` | List all members of the Attio workspace                                               |

## Filter and Sort Examples

Humm uses Attio's filter syntax to query records. Here are common patterns:

```
# List all people
object: "people"

# Filter by name
object: "people"
filter: {"name": "Ada Lovelace"}

# Filter with OR conditions
object: "people"
filter: {
  "$or": [
    {"name": {"first_name": {"$eq": "David"}}},
    {"name": {"first_name": {"$eq": "Steve"}}}
  ]
}

# Sort by last name ascending
object: "people"
sorts: [{"direction": "asc", "attribute": "name", "field": "last_name"}]

# Sort by creation date descending
object: "companies"
sorts: [{"direction": "desc", "attribute": "created_at"}]

# Pagination
object: "deals"
limit: 100
offset: 0
```

## Object Types

Attio supports querying different object types:

* **people** - Contact records with names, emails, and custom fields
* **companies** - Organization records with company details
* **deals** - Deal/opportunity records for pipeline tracking

Use the object slug (e.g., `"people"`, `"companies"`, `"deals"`) or UUID to specify which object type to query.

## Authentication

<Card title="OAuth" icon="plug">
  Connect securely via Attio OAuth. Authorize Humm to access your Attio workspace.
</Card>