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

# Attio

> Attio Scenario seeding parameters, nested fields, and examples

Use `attio` in `twins` and put this configuration under `seed_config.attio`.

Attio CRM workspace with companies, people, deals, custom lists and attributes, notes, tasks, meetings, files, and webhooks.

## Example seed

This is the complete Scenario request body for [creating a Scenario](https://docs.argalabs.com/api-reference/post-create-a-scenario.md). You can also import it with `arga test-runner scenarios import --file scenario.json`.

```json theme={null}
{
  "name": "Attio eval fixture",
  "twins": [
    "attio"
  ],
  "seed_config": {
    "attio": {
      "companies": [
        {
          "name": "Analytical Engines",
          "domains": [
            "analytical.example.com"
          ],
          "description": "Enterprise prospect",
          "primary_location": {
            "locality": "London",
            "country_code": "GB"
          }
        }
      ],
      "people": [
        {
          "first_name": "Ada",
          "last_name": "Lovelace",
          "email": "ada@example.com",
          "job_title": "Founder",
          "company_domain": "analytical.example.com"
        }
      ],
      "deals": [
        {
          "name": "Enterprise pilot",
          "stage": "In Progress",
          "value": 25000,
          "currency": "USD",
          "company_domain": "analytical.example.com",
          "people_emails": [
            "ada@example.com"
          ],
          "close_date": "2026-03-31"
        }
      ],
      "lists": [
        {
          "name": "Sales Pipeline",
          "api_slug": "sales_pipeline",
          "parent_object": "deals",
          "attributes": [
            {
              "title": "Priority",
              "api_slug": "priority",
              "type": "select",
              "options": [
                "High",
                "Medium",
                "Low"
              ]
            }
          ],
          "entries": [
            {
              "deal_name": "Enterprise pilot",
              "entry_values": {
                "priority": "High"
              }
            }
          ]
        }
      ],
      "tasks": [
        {
          "content_plaintext": "Send pilot proposal",
          "deadline_at": "2026-02-01",
          "linked_records": [],
          "assignees": []
        }
      ],
      "notes": [
        {
          "person_email": "ada@example.com",
          "title": "Discovery notes",
          "format": "markdown",
          "content": "## Summary\nStrong fit for the pilot."
        }
      ],
      "webhooks": [
        {
          "target_url": "https://example.test/attio-webhook",
          "subscriptions": [
            {
              "event_type": "record.updated",
              "filter": null
            }
          ]
        }
      ]
    }
  }
}
```

## Parameters

The following fields belong directly inside `seed_config.attio`. Required nested fields are marked in their tables. Provider-native objects can contain service-specific fields beyond the representative record shapes below.

| Parameter | Type | Description |
| - | - | - |
| `companies` | `object[]` | Companies fixtures in provider-native format. |
| `people` | `object[]` | People fixtures in provider-native format. |
| `deals` | `object[]` | Deals fixtures in provider-native format. |
| `lists` | `object[]` | Lists fixtures in provider-native format. |
| `tasks` | `object[]` | Tasks fixtures in provider-native format. |
| `notes` | `object[]` | Notes fixtures in provider-native format. |
| `webhooks` | `object[]` | Webhook subscriptions or configurations. |

## Resource fields

These tables describe the record shapes used by the example. Keep native field names and casing. Map keys such as property names, IDs, and metadata keys are supplied by your fixture.

### `companies[]`

| Parameter | Type | Description |
| - | - | - |
| `name` | `string` | Human-readable name. |
| `domains` | `string[]` | Domains fixtures in provider-native format. |
| `description` | `string` | Description. |
| `primary_location` | `object` | Primary location. |

### `people[]`

| Parameter | Type | Description |
| - | - | - |
| `first_name` | `string` | First name. |
| `last_name` | `string` | Last name. |
| `email` | `string` | Main account email address. |
| `job_title` | `string` | Job title. |
| `company_domain` | `string` | Company domain. |

### `deals[]`

| Parameter | Type | Description |
| - | - | - |
| `name` | `string` | Human-readable name. |
| `stage` | `string` | Stage. |
| `value` | `integer` | Value. |
| `currency` | `string` | Currency. |
| `company_domain` | `string` | Company domain. |
| `people_emails` | `string[]` | People emails fixtures in provider-native format. |
| `close_date` | `string` | Close date. |

### `lists[]`

| Parameter | Type | Description |
| - | - | - |
| `name` | `string` | Human-readable name. |
| `api_slug` | `string` | Api slug. |
| `parent_object` | `string` | Parent object. |
| `attributes` | `object[]` | Attributes fixtures in provider-native format. |
| `entries` | `object[]` | Entries fixtures in provider-native format. |

### `lists[].attributes[]`

| Parameter | Type | Description |
| - | - | - |
| `title` | `string` | Human-readable name. |
| `api_slug` | `string` | Api slug. |
| `type` | `string` | Type. |
| `options` | `string[]` | Options fixtures in provider-native format. |

### `lists[].entries[]`

| Parameter | Type | Description |
| - | - | - |
| `deal_name` | `string` | Deal name. |
| `entry_values` | `object` | Entry values. |

### `tasks[]`

| Parameter | Type | Description |
| - | - | - |
| `content_plaintext` | `string` | Content plaintext. |
| `deadline_at` | `string` | Deadline at. |
| `linked_records` | `array` | Linked records fixtures in provider-native format. |
| `assignees` | `array` | Assignees fixtures in provider-native format. |

### `notes[]`

| Parameter | Type | Description |
| - | - | - |
| `person_email` | `string` | Person email. |
| `title` | `string` | Human-readable name. |
| `format` | `string` | Format. |
| `content` | `string` | Text content. |

### `webhooks[]`

| Parameter | Type | Description |
| - | - | - |
| `target_url` | `string` | Target url. |
| `subscriptions` | `object[]` | Event subscriptions. |

### `webhooks[].subscriptions[]`

| Parameter | Type | Description |
| - | - | - |
| `event_type` | `string` | Event type. |
| `filter` | `any` | Filter. |

See [Scenario seeding](https://docs.argalabs.com/twins/seeding.md) for saving, provisioning, and resetting fixtures.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.