Loading import_attio_list

import_attio_list

Import an Attio list — or chosen entries of it — into a campaign as a durable operation, creating unified leads through the same primitive as a single import.

# MCP tool reference

1 callable tools.

Use tools/call at https://mcp.schedulerzero.com/mcp with the exact tool name and arguments below. The /tools/ paths in this view are documentation identifiers, not HTTP endpoints. Request execution is disabled for this reference.

Inputs are shown for personal API keys (bound) and for OAuth/delegated agents. Output schemas describe MCP structuredContent: native objects pass through; arrays, scalars and null use a data wrapper. Text content retains the native JSON result.

[Connect a client](/mcp/connect) · [Authentication and authorization](/authentication) · [Generated auth guide](/auth.md) · [Download tool catalog](/mcp-catalog.json) · [Agent documentation](/llms.txt)

## import_attio_list

Import an Attio list — or chosen entries of it — into a campaign as a durable operation, creating unified leads through the same primitive as a single import.

Use for bulk imports. Poll the returned operation handle, then read the import record (read_attio_records import_history or import_details) for counts and row failures.

Refused with Conflict while an import of the same list into the same campaign is still running. People without an email are skipped and reported, never enrolled.

Scopes: lead:import, integration:read

Risk: write; confirmation: none; idempotency: supported.

### Input schema (personal API key)

```json
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
      "format": "uuid"
    },
    "import": {
      "type": "object",
      "properties": {
        "listId": {
          "$ref": "#/$defs/ProviderId"
        },
        "campaignId": {
          "type": "string",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
          "format": "uuid"
        },
        "mappingId": {
          "$ref": "#/$defs/AttioFieldMappingId"
        },
        "emailStrategy": {
          "type": "string",
          "enum": [
            "first",
            "work",
            "personal"
          ]
        },
        "duplicateBehavior": {
          "type": "string",
          "enum": [
            "skip",
            "update"
          ]
        },
        "entryIds": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ProviderId"
          },
          "minItems": 1,
          "maxItems": 10000
        }
      },
      "required": [
        "listId",
        "campaignId"
      ],
      "patternProperties": {
        "^(?!(?:listId|campaignId|mappingId|emailStrategy|duplicateBehavior|entryIds)$)[\\s\\S]*$": false
      },
      "additionalProperties": true,
      "propertyNames": {
        "type": "string",
        "enum": [
          "listId",
          "campaignId",
          "mappingId",
          "emailStrategy",
          "duplicateBehavior",
          "entryIds"
        ]
      }
    }
  },
  "required": [
    "workspaceId",
    "import"
  ],
  "patternProperties": {
    "^(?!(?:workspaceId|import)$)[\\s\\S]*$": false
  },
  "additionalProperties": true,
  "propertyNames": {
    "type": "string",
    "enum": [
      "workspaceId",
      "import"
    ]
  },
  "$defs": {
    "ProviderId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "AttioFieldMappingId": {
      "type": "string",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
      "format": "uuid"
    }
  }
}
```

### Input schema (OAuth / delegated agent)

```json
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
      "format": "uuid"
    },
    "import": {
      "type": "object",
      "properties": {
        "listId": {
          "$ref": "#/$defs/ProviderId"
        },
        "campaignId": {
          "type": "string",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
          "format": "uuid"
        },
        "mappingId": {
          "$ref": "#/$defs/AttioFieldMappingId"
        },
        "emailStrategy": {
          "type": "string",
          "enum": [
            "first",
            "work",
            "personal"
          ]
        },
        "duplicateBehavior": {
          "type": "string",
          "enum": [
            "skip",
            "update"
          ]
        },
        "entryIds": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ProviderId"
          },
          "minItems": 1,
          "maxItems": 10000
        }
      },
      "required": [
        "listId",
        "campaignId"
      ],
      "patternProperties": {
        "^(?!(?:listId|campaignId|mappingId|emailStrategy|duplicateBehavior|entryIds)$)[\\s\\S]*$": false
      },
      "additionalProperties": true,
      "propertyNames": {
        "type": "string",
        "enum": [
          "listId",
          "campaignId",
          "mappingId",
          "emailStrategy",
          "duplicateBehavior",
          "entryIds"
        ]
      }
    }
  },
  "required": [
    "workspaceId",
    "import"
  ],
  "patternProperties": {
    "^(?!(?:workspaceId|import)$)[\\s\\S]*$": false
  },
  "additionalProperties": true,
  "propertyNames": {
    "type": "string",
    "enum": [
      "workspaceId",
      "import"
    ]
  },
  "$defs": {
    "ProviderId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "AttioFieldMappingId": {
      "type": "string",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
      "format": "uuid"
    }
  }
}
```

### Output schema (structuredContent)

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
      "format": "uuid"
    },
    "statusUrl": {
      "anyOf": [
        {
          "$ref": "#/$defs/HttpUrl"
        },
        {
          "$ref": "#/$defs/HttpResourcePath"
        }
      ]
    },
    "state": {
      "type": "string",
      "enum": [
        "queued",
        "running",
        "waiting_for_user",
        "succeeded",
        "partially_succeeded",
        "failed",
        "canceled",
        "canceling"
      ]
    },
    "acceptedAt": {
      "$ref": "#/$defs/UtcDateTimeEncoded"
    },
    "progress": {
      "type": "object",
      "properties": {
        "completed": {
          "type": "integer",
          "minimum": 0
        },
        "total": {
          "type": "integer",
          "minimum": 0
        },
        "message": {
          "$ref": "#/$defs/NonEmptyString"
        }
      },
      "required": [
        "completed"
      ],
      "patternProperties": {
        "^(?!(?:completed|total|message)$)[\\s\\S]*$": false
      },
      "additionalProperties": true,
      "propertyNames": {
        "type": "string",
        "enum": [
          "completed",
          "total",
          "message"
        ]
      }
    },
    "canCancel": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "statusUrl",
    "state",
    "acceptedAt",
    "canCancel"
  ],
  "patternProperties": {
    "^(?!(?:id|statusUrl|state|acceptedAt|progress|canCancel)$)[\\s\\S]*$": false
  },
  "additionalProperties": true,
  "propertyNames": {
    "type": "string",
    "enum": [
      "id",
      "statusUrl",
      "state",
      "acceptedAt",
      "progress",
      "canCancel"
    ]
  },
  "$defs": {
    "HttpUrl": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "pattern": "^https?:\\/\\/[^\\s/$.?#][^\\s]*$"
    },
    "HttpResourcePath": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "pattern": "^\\/[A-Za-z0-9._~!$&'()*+,;=:@/%-]*$"
    },
    "UtcDateTimeEncoded": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
    },
    "NonEmptyString": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    }
  }
}
```

### Underlying API operations

- `attioImports.list`: `POST /v1/workspaces/:workspaceId/integrations/attio/imports/list`

Related MCP tools

import_attio_person
Import one Attio person into a campaign as a unified lead plus its campaign contact, using the email address a person chose from the import preview.
manage_attio_mappings
Shape how Attio records import: save, change, or delete a named field mapping, and refresh the local catalog of Attio lists.
manage_attio_outbound
Turn the four outbound Attio writes on or off: automatic lead sync, and call, reply, and send activity notes.
push_lead_to_attio
Push one lead to its Attio person record now, as a durable job — creating the person on first push and refreshing it afterwards.
read_attio_records
Read the workspace's Attio CRM and its local Attio state: probe the connection, browse lists, list entries, people, companies, attributes, and workspace members, preview what an import would write, and read saved field mappings, import records, outbound toggles, and a lead's CRM link.
add_heyreach_leads
Push up to 100 leads into a HeyReach campaign (optionally pinned to a sender) or a HeyReach list, and report how many were added, updated, or failed.

See how this works in Scheduler Zero