# 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) ## 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. Use before proposing an import (to find the list or person and preview the email that would be chosen), to explain why a lead is or is not in Attio, and to ground any claim about which outbound writes are switched on. The cached_lists scope uses offset pagination: request up to 100 items (default 50) and continue at pagination.offset + pagination.limit while pagination.hasMore is true. Provider reads answer TemporarilyUnavailable while Attio is unconnected or awaiting reauthorization — that is a state to report, not an error to retry. The cached list catalog does not call Attio; sync it through manage_attio_mappings when it looks stale. A lead link of null means not linked yet, including while a creation is in flight. This never writes anything, locally or in Attio. Scopes: integration:read, lead:read Risk: read; confirmation: none; idempotency: none. ### 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" }, "scope": { "type": "string", "enum": [ "connection_test", "mappings", "default_mapping", "cached_lists", "list_attributes", "list_entries", "list_entry", "people_attributes", "company_attributes", "people_search", "person", "person_import_preview", "workspace_members", "import_history", "import_details", "outbound_settings", "lead_link" ] }, "listId": { "$ref": "#/$defs/ProviderId" }, "entryId": { "$ref": "#/$defs/ProviderId" }, "recordId": { "$ref": "#/$defs/ProviderId" }, "importId": { "$ref": "#/$defs/AttioImportId" }, "leadId": { "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" }, "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" }, "parentObject": { "type": "string", "enum": [ "people", "companies" ] }, "search": { "type": "string", "minLength": 1, "maxLength": 256 }, "emailStrategy": { "type": "string", "enum": [ "first", "work", "personal" ] }, "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "required": [ "workspaceId", "scope" ], "patternProperties": { "^(?!(?:workspaceId|scope|listId|entryId|recordId|importId|leadId|campaignId|parentObject|search|emailStrategy|offset|limit)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "scope", "listId", "entryId", "recordId", "importId", "leadId", "campaignId", "parentObject", "search", "emailStrategy", "offset", "limit" ] }, "$defs": { "ProviderId": { "type": "string", "minLength": 1, "maxLength": 512 }, "AttioImportId": { "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" }, "scope": { "type": "string", "enum": [ "connection_test", "mappings", "default_mapping", "cached_lists", "list_attributes", "list_entries", "list_entry", "people_attributes", "company_attributes", "people_search", "person", "person_import_preview", "workspace_members", "import_history", "import_details", "outbound_settings", "lead_link" ] }, "listId": { "$ref": "#/$defs/ProviderId" }, "entryId": { "$ref": "#/$defs/ProviderId" }, "recordId": { "$ref": "#/$defs/ProviderId" }, "importId": { "$ref": "#/$defs/AttioImportId" }, "leadId": { "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" }, "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" }, "parentObject": { "type": "string", "enum": [ "people", "companies" ] }, "search": { "type": "string", "minLength": 1, "maxLength": 256 }, "emailStrategy": { "type": "string", "enum": [ "first", "work", "personal" ] }, "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "required": [ "workspaceId", "scope" ], "patternProperties": { "^(?!(?:workspaceId|scope|listId|entryId|recordId|importId|leadId|campaignId|parentObject|search|emailStrategy|offset|limit)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "scope", "listId", "entryId", "recordId", "importId", "leadId", "campaignId", "parentObject", "search", "emailStrategy", "offset", "limit" ] }, "$defs": { "ProviderId": { "type": "string", "minLength": 1, "maxLength": 512 }, "AttioImportId": { "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 { "$defs": { "ProviderId": { "type": "string", "minLength": 1, "maxLength": 512 }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 }, "AttioConnectionTestResult": { "anyOf": [ { "type": "object", "properties": { "status": { "anyOf": [ { "type": "string", "enum": [ "connected" ] } ] }, "providerWorkspaceId": { "$ref": "#/$defs/ProviderId" }, "providerWorkspaceName": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "grantedScopes": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 100 } }, "required": [ "status", "providerWorkspaceId", "providerWorkspaceName", "grantedScopes" ], "patternProperties": { "^(?!(?:status|providerWorkspaceId|providerWorkspaceName|grantedScopes)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "status", "providerWorkspaceId", "providerWorkspaceName", "grantedScopes" ] } }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_connected", "reauthorization_required", "provider_unreachable" ] } }, "required": [ "status" ], "patternProperties": { "^(?!(?:status)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "status" ] } ] } } ] }, "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" }, "AttioFieldMappingRules": { "type": "object", "additionalProperties": true, "minProperties": 0, "maxProperties": 200 }, "UtcDateTimeEncoded": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" }, "AttioFieldMapping": { "type": "object", "properties": { "id": { "$ref": "#/$defs/AttioFieldMappingId" }, "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" }, "name": { "$ref": "#/$defs/ShortText" }, "rules": { "$ref": "#/$defs/AttioFieldMappingRules" }, "emailStrategy": { "type": "string", "enum": [ "first", "work", "personal", "ask" ] }, "duplicateBehavior": { "type": "string", "enum": [ "skip", "update" ] }, "isDefault": { "type": "boolean" }, "providerWorkspaceId": { "anyOf": [ { "$ref": "#/$defs/ProviderId" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "workspaceId", "name", "rules", "emailStrategy", "duplicateBehavior", "isDefault", "providerWorkspaceId", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|workspaceId|name|rules|emailStrategy|duplicateBehavior|isDefault|providerWorkspaceId|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "workspaceId", "name", "rules", "emailStrategy", "duplicateBehavior", "isDefault", "providerWorkspaceId", "createdAt", "updatedAt" ] } }, "AttioDefaultFieldMapping": { "anyOf": [ { "type": "object", "properties": { "kind": { "anyOf": [ { "type": "string", "enum": [ "saved" ] } ] }, "mapping": { "$ref": "#/$defs/AttioFieldMapping" } }, "required": [ "kind", "mapping" ], "patternProperties": { "^(?!(?:kind|mapping)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "kind", "mapping" ] } }, { "type": "object", "properties": { "kind": { "anyOf": [ { "type": "string", "enum": [ "suggested" ] } ] }, "rules": { "$ref": "#/$defs/AttioFieldMappingRules" } }, "required": [ "kind", "rules" ], "patternProperties": { "^(?!(?:kind|rules)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "kind", "rules" ] } } ] }, "AttioCachedList": { "type": "object", "properties": { "listId": { "$ref": "#/$defs/ProviderId" }, "name": { "$ref": "#/$defs/ShortText" }, "parentObject": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "entryCount": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "lastSyncedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] } }, "required": [ "listId", "name", "parentObject", "entryCount", "lastSyncedAt" ], "patternProperties": { "^(?!(?:listId|name|parentObject|entryCount|lastSyncedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "listId", "name", "parentObject", "entryCount", "lastSyncedAt" ] } }, "AttioAttribute": { "type": "object", "properties": { "id": { "$ref": "#/$defs/ProviderId" }, "title": { "$ref": "#/$defs/ShortText" }, "apiSlug": { "$ref": "#/$defs/ShortText" }, "type": { "$ref": "#/$defs/ShortText" }, "isRequired": { "type": "boolean" }, "isMultiselect": { "type": "boolean" }, "isWritable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] } }, "required": [ "id", "title", "apiSlug", "type", "isRequired", "isMultiselect", "isWritable" ], "patternProperties": { "^(?!(?:id|title|apiSlug|type|isRequired|isMultiselect|isWritable)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "title", "apiSlug", "type", "isRequired", "isMultiselect", "isWritable" ] } }, "Union_": { "anyOf": [ { "type": "null" }, { "type": "boolean" }, { "type": "number" }, { "type": "string" }, { "type": "array", "items": { "$ref": "#/$defs/Union_" } }, { "type": "object", "additionalProperties": { "$ref": "#/$defs/Union_" } } ] }, "AttioRecordValues": { "type": "object", "additionalProperties": { "$ref": "#/$defs/Union_" }, "minProperties": 0, "maxProperties": 1000 }, "AttioListEntry": { "type": "object", "properties": { "entryId": { "$ref": "#/$defs/ProviderId" }, "recordId": { "$ref": "#/$defs/ProviderId" }, "createdAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "values": { "$ref": "#/$defs/AttioRecordValues" } }, "required": [ "entryId", "recordId", "createdAt", "values" ], "patternProperties": { "^(?!(?:entryId|recordId|createdAt|values)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "entryId", "recordId", "createdAt", "values" ] } }, "LeadStoredText": { "type": "string", "maxLength": 65536 }, "AttioPersonSummary": { "type": "object", "properties": { "recordId": { "$ref": "#/$defs/ProviderId" }, "name": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "firstName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "emails": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 100 }, "jobTitle": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "companyRecordId": { "anyOf": [ { "$ref": "#/$defs/ProviderId" }, { "type": "null" } ] } }, "required": [ "recordId", "name", "firstName", "lastName", "emails", "jobTitle", "companyRecordId" ], "patternProperties": { "^(?!(?:recordId|name|firstName|lastName|emails|jobTitle|companyRecordId)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "recordId", "name", "firstName", "lastName", "emails", "jobTitle", "companyRecordId" ] } }, "AttioCompany": { "type": "object", "properties": { "recordId": { "$ref": "#/$defs/ProviderId" }, "name": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "domain": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "websiteUrl": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "values": { "$ref": "#/$defs/AttioRecordValues" } }, "required": [ "recordId", "name", "domain", "websiteUrl", "values" ], "patternProperties": { "^(?!(?:recordId|name|domain|websiteUrl|values)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "recordId", "name", "domain", "websiteUrl", "values" ] } }, "AttioPerson": { "type": "object", "properties": { "recordId": { "$ref": "#/$defs/ProviderId" }, "name": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "firstName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "emails": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 100 }, "values": { "$ref": "#/$defs/AttioRecordValues" }, "company": { "anyOf": [ { "$ref": "#/$defs/AttioCompany" }, { "type": "null" } ] } }, "required": [ "recordId", "name", "firstName", "lastName", "emails", "values", "company" ], "patternProperties": { "^(?!(?:recordId|name|firstName|lastName|emails|values|company)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "recordId", "name", "firstName", "lastName", "emails", "values", "company" ] } }, "AttioPersonImportPreview": { "type": "object", "properties": { "recordId": { "$ref": "#/$defs/ProviderId" }, "emails": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 100 }, "selectedEmail": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "hasMultipleEmails": { "type": "boolean" }, "firstName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "jobTitle": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "city": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "region": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "country": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "company": { "anyOf": [ { "type": "object", "properties": { "recordId": { "$ref": "#/$defs/ProviderId" }, "name": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "domain": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "websiteUrl": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] } }, "required": [ "recordId", "name", "domain", "websiteUrl" ], "patternProperties": { "^(?!(?:recordId|name|domain|websiteUrl)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "recordId", "name", "domain", "websiteUrl" ] } }, { "type": "null" } ] }, "values": { "$ref": "#/$defs/AttioRecordValues" } }, "required": [ "recordId", "emails", "selectedEmail", "hasMultipleEmails", "firstName", "lastName", "jobTitle", "city", "region", "country", "company", "values" ], "patternProperties": { "^(?!(?:recordId|emails|selectedEmail|hasMultipleEmails|firstName|lastName|jobTitle|city|region|country|company|values)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "recordId", "emails", "selectedEmail", "hasMultipleEmails", "firstName", "lastName", "jobTitle", "city", "region", "country", "company", "values" ] } }, "HttpUrl": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^https?:\\/\\/[^\\s/$.?#][^\\s]*$" }, "AttioWorkspaceMember": { "type": "object", "properties": { "memberId": { "$ref": "#/$defs/ProviderId" }, "name": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "firstName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "email": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "avatarUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "type": "null" } ] }, "accessLevel": { "$ref": "#/$defs/ShortText" }, "active": { "type": "boolean" } }, "required": [ "memberId", "name", "firstName", "lastName", "email", "avatarUrl", "accessLevel", "active" ], "patternProperties": { "^(?!(?:memberId|name|firstName|lastName|email|avatarUrl|accessLevel|active)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "memberId", "name", "firstName", "lastName", "email", "avatarUrl", "accessLevel", "active" ] } }, "AttioWorkspaceMembersResult": { "anyOf": [ { "type": "object", "properties": { "status": { "anyOf": [ { "type": "string", "enum": [ "loaded" ] } ] }, "items": { "type": "array", "items": { "$ref": "#/$defs/AttioWorkspaceMember" }, "maxItems": 1000 } }, "required": [ "status", "items" ], "patternProperties": { "^(?!(?:status|items)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "status", "items" ] } }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "not_connected", "reauthorization_required", "provider_unreachable" ] } }, "required": [ "status" ], "patternProperties": { "^(?!(?:status)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "status" ] } ] } } ] }, "AttioImportId": { "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" }, "AttioImportRecord": { "type": "object", "properties": { "id": { "$ref": "#/$defs/AttioImportId" }, "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" }, "status": { "type": "string", "enum": [ "pending", "in_progress", "completed", "partial", "failed" ] }, "sourceType": { "type": "string", "enum": [ "people", "list" ] }, "sourceId": { "anyOf": [ { "$ref": "#/$defs/ProviderId" }, { "type": "null" } ] }, "sourceName": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "campaignId": { "anyOf": [ { "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" }, { "type": "null" } ] }, "fieldMappingId": { "anyOf": [ { "$ref": "#/$defs/AttioFieldMappingId" }, { "type": "null" } ] }, "operationId": { "anyOf": [ { "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" }, { "type": "null" } ] }, "totalRecords": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "successCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "failedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "skippedCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "startedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "completedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "workspaceId", "status", "sourceType", "sourceId", "sourceName", "campaignId", "fieldMappingId", "operationId", "totalRecords", "successCount", "failedCount", "skippedCount", "startedAt", "completedAt", "createdAt" ], "patternProperties": { "^(?!(?:id|workspaceId|status|sourceType|sourceId|sourceName|campaignId|fieldMappingId|operationId|totalRecords|successCount|failedCount|skippedCount|startedAt|completedAt|createdAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "workspaceId", "status", "sourceType", "sourceId", "sourceName", "campaignId", "fieldMappingId", "operationId", "totalRecords", "successCount", "failedCount", "skippedCount", "startedAt", "completedAt", "createdAt" ] } }, "AttioImportDetail": { "type": "object", "properties": { "import": { "$ref": "#/$defs/AttioImportRecord" }, "errors": { "type": "array", "items": { "type": "object", "properties": { "recordId": { "anyOf": [ { "$ref": "#/$defs/ProviderId" }, { "type": "null" } ] }, "email": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "error": { "$ref": "#/$defs/ShortText" } }, "required": [ "recordId", "email", "error" ], "patternProperties": { "^(?!(?:recordId|email|error)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "recordId", "email", "error" ] } }, "maxItems": 100 } }, "required": [ "import", "errors" ], "patternProperties": { "^(?!(?:import|errors)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "import", "errors" ] } }, "AttioOutboundSettings": { "type": "object", "properties": { "pushLeads": { "type": "boolean" }, "pushCallNotes": { "type": "boolean" }, "pushReplyNotes": { "type": "boolean" }, "pushSendNotes": { "type": "boolean" } }, "required": [ "pushLeads", "pushCallNotes", "pushReplyNotes", "pushSendNotes" ], "patternProperties": { "^(?!(?:pushLeads|pushCallNotes|pushReplyNotes|pushSendNotes)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "pushLeads", "pushCallNotes", "pushReplyNotes", "pushSendNotes" ] } }, "AttioOutboundSettingsResult": { "type": "object", "properties": { "connected": { "type": "boolean" }, "settings": { "$ref": "#/$defs/AttioOutboundSettings" } }, "required": [ "connected", "settings" ], "patternProperties": { "^(?!(?:connected|settings)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "connected", "settings" ] } }, "AttioLeadLink": { "type": "object", "properties": { "provider": { "anyOf": [ { "type": "string", "enum": [ "attio" ] } ] }, "object": { "$ref": "#/$defs/ShortText" }, "recordId": { "$ref": "#/$defs/ProviderId" }, "externalUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "type": "null" } ] }, "lastPushedAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "lastPushError": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] } }, "required": [ "provider", "object", "recordId", "externalUrl", "lastPushedAt", "lastPushError" ], "patternProperties": { "^(?!(?:provider|object|recordId|externalUrl|lastPushedAt|lastPushError)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "provider", "object", "recordId", "externalUrl", "lastPushedAt", "lastPushError" ] } }, "AttioLeadLinkResult": { "type": "object", "properties": { "connected": { "type": "boolean" }, "providerWorkspaceName": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "settings": { "$ref": "#/$defs/AttioOutboundSettings" }, "link": { "anyOf": [ { "$ref": "#/$defs/AttioLeadLink" }, { "type": "null" } ] } }, "required": [ "connected", "providerWorkspaceName", "settings", "link" ], "patternProperties": { "^(?!(?:connected|providerWorkspaceName|settings|link)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "connected", "providerWorkspaceName", "settings", "link" ] } } }, "type": "object", "anyOf": [ { "allOf": [ { "anyOf": [ { "$ref": "#/$defs/AttioConnectionTestResult" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioFieldMapping" }, "maxItems": 200 } }, "required": [ "items" ], "patternProperties": { "^(?!(?:items)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "items" ] } ] } }, { "$ref": "#/$defs/AttioDefaultFieldMapping" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioCachedList" }, "maxItems": 100 }, "pagination": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasMore": { "type": "boolean" } }, "required": [ "offset", "limit", "hasMore" ], "patternProperties": { "^(?!(?:offset|limit|hasMore)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "hasMore" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioAttribute" }, "maxItems": 1000 } }, "required": [ "items" ], "patternProperties": { "^(?!(?:items)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "items" ] } ] } }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioListEntry" }, "maxItems": 100 }, "pagination": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasMore": { "type": "boolean" } }, "required": [ "offset", "limit", "hasMore" ], "patternProperties": { "^(?!(?:offset|limit|hasMore)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "hasMore" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "$ref": "#/$defs/AttioListEntry" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioPersonSummary" }, "maxItems": 50 } }, "required": [ "items" ], "patternProperties": { "^(?!(?:items)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "items" ] } ] } }, { "$ref": "#/$defs/AttioPerson" }, { "$ref": "#/$defs/AttioPersonImportPreview" }, { "$ref": "#/$defs/AttioWorkspaceMembersResult" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioImportRecord" }, "maxItems": 100 }, "pagination": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasMore": { "type": "boolean" } }, "required": [ "offset", "limit", "hasMore" ], "patternProperties": { "^(?!(?:offset|limit|hasMore)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "hasMore" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "$ref": "#/$defs/AttioImportDetail" }, { "$ref": "#/$defs/AttioOutboundSettingsResult" }, { "$ref": "#/$defs/AttioLeadLinkResult" } ] }, { "type": "object" } ] }, { "type": "object", "properties": { "data": { "allOf": [ { "anyOf": [ { "$ref": "#/$defs/AttioConnectionTestResult" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioFieldMapping" }, "maxItems": 200 } }, "required": [ "items" ], "patternProperties": { "^(?!(?:items)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "items" ] } ] } }, { "$ref": "#/$defs/AttioDefaultFieldMapping" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioCachedList" }, "maxItems": 100 }, "pagination": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasMore": { "type": "boolean" } }, "required": [ "offset", "limit", "hasMore" ], "patternProperties": { "^(?!(?:offset|limit|hasMore)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "hasMore" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioAttribute" }, "maxItems": 1000 } }, "required": [ "items" ], "patternProperties": { "^(?!(?:items)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "items" ] } ] } }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioListEntry" }, "maxItems": 100 }, "pagination": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasMore": { "type": "boolean" } }, "required": [ "offset", "limit", "hasMore" ], "patternProperties": { "^(?!(?:offset|limit|hasMore)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "hasMore" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "$ref": "#/$defs/AttioListEntry" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioPersonSummary" }, "maxItems": 50 } }, "required": [ "items" ], "patternProperties": { "^(?!(?:items)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "items" ] } ] } }, { "$ref": "#/$defs/AttioPerson" }, { "$ref": "#/$defs/AttioPersonImportPreview" }, { "$ref": "#/$defs/AttioWorkspaceMembersResult" }, { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/$defs/AttioImportRecord" }, "maxItems": 100 }, "pagination": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasMore": { "type": "boolean" } }, "required": [ "offset", "limit", "hasMore" ], "patternProperties": { "^(?!(?:offset|limit|hasMore)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "hasMore" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "$ref": "#/$defs/AttioImportDetail" }, { "$ref": "#/$defs/AttioOutboundSettingsResult" }, { "$ref": "#/$defs/AttioLeadLinkResult" } ] }, { "not": { "type": "object" } } ] } }, "required": [ "data" ], "additionalProperties": false } ] } ``` ### Underlying API operations - `attio.testConnection`: `GET /v1/workspaces/:workspaceId/integrations/attio/test` - `attioMappings.list`: `GET /v1/workspaces/:workspaceId/integrations/attio/mappings` - `attioMappings.getDefault`: `GET /v1/workspaces/:workspaceId/integrations/attio/mappings/default` - `attioBrowse.lists`: `GET /v1/workspaces/:workspaceId/integrations/attio/lists` - `attioBrowse.listAttributes`: `GET /v1/workspaces/:workspaceId/integrations/attio/lists/:listId/attributes` - `attioBrowse.listEntries`: `GET /v1/workspaces/:workspaceId/integrations/attio/lists/:listId/entries` - `attioBrowse.listEntry`: `GET /v1/workspaces/:workspaceId/integrations/attio/lists/:listId/entries/:entryId` - `attioBrowse.peopleAttributes`: `GET /v1/workspaces/:workspaceId/integrations/attio/people/attributes` - `attioBrowse.companyAttributes`: `GET /v1/workspaces/:workspaceId/integrations/attio/companies/attributes` - `attioBrowse.searchPeople`: `GET /v1/workspaces/:workspaceId/integrations/attio/people/search` - `attioBrowse.person`: `GET /v1/workspaces/:workspaceId/integrations/attio/people/:recordId` - `attioBrowse.personImportPreview`: `GET /v1/workspaces/:workspaceId/integrations/attio/people/:recordId/import-preview` - `attioBrowse.workspaceMembers`: `GET /v1/workspaces/:workspaceId/integrations/attio/workspace-members` - `attioImports.history`: `GET /v1/workspaces/:workspaceId/integrations/attio/imports` - `attioImports.details`: `GET /v1/workspaces/:workspaceId/integrations/attio/imports/:importId` - `attioOutbound.settings`: `GET /v1/workspaces/:workspaceId/integrations/attio/outbound-settings` - `attioOutbound.leadLink`: `GET /v1/workspaces/:workspaceId/integrations/attio/leads/:leadId/link`