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.
# 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`