# 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) ## manage_call_lists Curate the lists a dialing session works through: create one, rename it, copy it, retire it, read the contacts in it, and import more from a CSV payload or an Attio people list. Use to prepare who a rep will call — build a fresh list for a segment, top one up with new rows, or read back what is queued and how far it has been worked. If the person asks to call this list, resolve its workspace slug with resolve_workspace and hand them `/{workspace.slug}/dialer/lists/{callListId}` in the Scheduler Zero web app. They can review the list, choose session settings, explicitly start dialing, and grant microphone access there; this handoff does not initiate a session or call. After they provide the session id, read progress with read_dialer_history. Deleting a list destroys every queue row in it, including dialing progress, and is refused while a published workflow or a live run still names it. An import only ever dials the numbers each uploaded row itself carried; it will not discover a matched lead's other numbers, and asking it to is a consent problem, not a missing feature. Lists the campaign engine owns cannot be edited here at all. Obtain the user's explicit authorization before invoking a write or destructive action. This is a client interaction requirement, not a server-issued approval token. Scopes: dialer:read, dialer:create, dialer:update, dialer:delete, lead:import, integration:read Risk: destructive; confirmation: explicit; 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" }, "action": { "type": "string", "enum": [ "list", "get", "create", "update", "duplicate", "delete", "list_contacts", "import_csv", "import_attio_list" ] }, "callListId": { "$ref": "#/$defs/CallListId" }, "list": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "search": { "type": "string", "minLength": 1, "maxLength": 200 }, "sortBy": { "type": "string", "enum": [ "name", "createdAt", "updatedAt" ] }, "sortOrder": { "type": "string", "enum": [ "asc", "desc" ] } }, "patternProperties": { "^(?!(?:offset|limit|search|sortBy|sortOrder)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "search", "sortBy", "sortOrder" ] } }, "contacts": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "status": { "type": "string", "enum": [ "not_called", "queued", "in_progress", "called", "completed", "skipped", "callback", "dnc", "failed" ] }, "search": { "type": "string", "minLength": 1, "maxLength": 200 } }, "patternProperties": { "^(?!(?:offset|limit|status|search)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "status", "search" ] } }, "create": { "type": "object", "properties": { "name": { "$ref": "#/$defs/ShortText" }, "defaultTimezone": { "$ref": "#/$defs/IanaTimeZone" }, "customFieldNames": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 100 } }, "required": [ "name" ], "patternProperties": { "^(?!(?:name|defaultTimezone|customFieldNames)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "name", "defaultTimezone", "customFieldNames" ] } }, "update": { "type": "object", "properties": { "name": { "$ref": "#/$defs/ShortText" }, "customFieldNames": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 100 } }, "patternProperties": { "^(?!(?:name|customFieldNames)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "name", "customFieldNames" ] }, "minProperties": 1, "maxProperties": 2 }, "importCsv": { "type": "object", "properties": { "contacts": { "type": "array", "items": { "type": "object", "properties": { "phone": { "$ref": "#/$defs/ShortText" }, "phones": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 9 }, "firstName": { "$ref": "#/$defs/ShortText" }, "lastName": { "$ref": "#/$defs/ShortText" }, "email": { "$ref": "#/$defs/ShortText" }, "companyName": { "$ref": "#/$defs/ShortText" }, "jobTitle": { "$ref": "#/$defs/ShortText" }, "companyWebsiteUrl": { "$ref": "#/$defs/ShortText" }, "personalLinkedInUrl": { "$ref": "#/$defs/ShortText" }, "companyLinkedInUrl": { "$ref": "#/$defs/ShortText" }, "city": { "$ref": "#/$defs/ShortText" }, "state": { "$ref": "#/$defs/ShortText" }, "country": { "$ref": "#/$defs/ShortText" }, "timezone": { "$ref": "#/$defs/ShortText" }, "customFields": { "type": "object", "additionalProperties": true } }, "required": [ "phone" ], "patternProperties": { "^(?!(?:phone|phones|firstName|lastName|email|companyName|jobTitle|companyWebsiteUrl|personalLinkedInUrl|companyLinkedInUrl|city|state|country|timezone|customFields)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "phone", "phones", "firstName", "lastName", "email", "companyName", "jobTitle", "companyWebsiteUrl", "personalLinkedInUrl", "companyLinkedInUrl", "city", "state", "country", "timezone", "customFields" ] } }, "minItems": 1, "maxItems": 50000 } }, "required": [ "contacts" ], "patternProperties": { "^(?!(?:contacts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "contacts" ] } ] } }, "importAttioList": { "type": "object", "properties": { "attioListId": { "$ref": "#/$defs/ProviderId" }, "emailStrategy": { "type": "string", "enum": [ "first", "work", "personal" ] } }, "required": [ "attioListId" ], "patternProperties": { "^(?!(?:attioListId|emailStrategy)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "attioListId", "emailStrategy" ] } } }, "required": [ "workspaceId", "action" ], "patternProperties": { "^(?!(?:workspaceId|action|callListId|list|contacts|create|update|importCsv|importAttioList)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "action", "callListId", "list", "contacts", "create", "update", "importCsv", "importAttioList" ] }, "$defs": { "CallListId": { "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" }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 }, "IanaTimeZone": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^(?:UTC|[A-Za-z0-9_+-]+(?:\\/[A-Za-z0-9_+-]+)+)$" }, "CallListCustomFieldValue": { "type": "string", "maxLength": 4096 }, "ProviderId": { "type": "string", "minLength": 1, "maxLength": 512 } } } ``` ### 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" }, "action": { "type": "string", "enum": [ "list", "get", "create", "update", "duplicate", "delete", "list_contacts", "import_csv", "import_attio_list" ] }, "callListId": { "$ref": "#/$defs/CallListId" }, "list": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "search": { "type": "string", "minLength": 1, "maxLength": 200 }, "sortBy": { "type": "string", "enum": [ "name", "createdAt", "updatedAt" ] }, "sortOrder": { "type": "string", "enum": [ "asc", "desc" ] } }, "patternProperties": { "^(?!(?:offset|limit|search|sortBy|sortOrder)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "search", "sortBy", "sortOrder" ] } }, "contacts": { "type": "object", "properties": { "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "status": { "type": "string", "enum": [ "not_called", "queued", "in_progress", "called", "completed", "skipped", "callback", "dnc", "failed" ] }, "search": { "type": "string", "minLength": 1, "maxLength": 200 } }, "patternProperties": { "^(?!(?:offset|limit|status|search)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "offset", "limit", "status", "search" ] } }, "create": { "type": "object", "properties": { "name": { "$ref": "#/$defs/ShortText" }, "defaultTimezone": { "$ref": "#/$defs/IanaTimeZone" }, "customFieldNames": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 100 } }, "required": [ "name" ], "patternProperties": { "^(?!(?:name|defaultTimezone|customFieldNames)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "name", "defaultTimezone", "customFieldNames" ] } }, "update": { "type": "object", "properties": { "name": { "$ref": "#/$defs/ShortText" }, "customFieldNames": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 100 } }, "patternProperties": { "^(?!(?:name|customFieldNames)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "name", "customFieldNames" ] }, "minProperties": 1, "maxProperties": 2 }, "importCsv": { "type": "object", "properties": { "contacts": { "type": "array", "items": { "type": "object", "properties": { "phone": { "$ref": "#/$defs/ShortText" }, "phones": { "type": "array", "items": { "$ref": "#/$defs/ShortText" }, "maxItems": 9 }, "firstName": { "$ref": "#/$defs/ShortText" }, "lastName": { "$ref": "#/$defs/ShortText" }, "email": { "$ref": "#/$defs/ShortText" }, "companyName": { "$ref": "#/$defs/ShortText" }, "jobTitle": { "$ref": "#/$defs/ShortText" }, "companyWebsiteUrl": { "$ref": "#/$defs/ShortText" }, "personalLinkedInUrl": { "$ref": "#/$defs/ShortText" }, "companyLinkedInUrl": { "$ref": "#/$defs/ShortText" }, "city": { "$ref": "#/$defs/ShortText" }, "state": { "$ref": "#/$defs/ShortText" }, "country": { "$ref": "#/$defs/ShortText" }, "timezone": { "$ref": "#/$defs/ShortText" }, "customFields": { "type": "object", "additionalProperties": true } }, "required": [ "phone" ], "patternProperties": { "^(?!(?:phone|phones|firstName|lastName|email|companyName|jobTitle|companyWebsiteUrl|personalLinkedInUrl|companyLinkedInUrl|city|state|country|timezone|customFields)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "phone", "phones", "firstName", "lastName", "email", "companyName", "jobTitle", "companyWebsiteUrl", "personalLinkedInUrl", "companyLinkedInUrl", "city", "state", "country", "timezone", "customFields" ] } }, "minItems": 1, "maxItems": 50000 } }, "required": [ "contacts" ], "patternProperties": { "^(?!(?:contacts)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "contacts" ] } ] } }, "importAttioList": { "type": "object", "properties": { "attioListId": { "$ref": "#/$defs/ProviderId" }, "emailStrategy": { "type": "string", "enum": [ "first", "work", "personal" ] } }, "required": [ "attioListId" ], "patternProperties": { "^(?!(?:attioListId|emailStrategy)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "attioListId", "emailStrategy" ] } } }, "required": [ "workspaceId", "action" ], "patternProperties": { "^(?!(?:workspaceId|action|callListId|list|contacts|create|update|importCsv|importAttioList)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "action", "callListId", "list", "contacts", "create", "update", "importCsv", "importAttioList" ] }, "$defs": { "CallListId": { "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" }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 }, "IanaTimeZone": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^(?:UTC|[A-Za-z0-9_+-]+(?:\\/[A-Za-z0-9_+-]+)+)$" }, "CallListCustomFieldValue": { "type": "string", "maxLength": 4096 }, "ProviderId": { "type": "string", "minLength": 1, "maxLength": 512 } } } ``` ### Output schema (structuredContent) ```json { "$defs": { "CallListId": { "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" }, "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 }, "IanaTimeZone": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^(?:UTC|[A-Za-z0-9_+-]+(?:\\/[A-Za-z0-9_+-]+)+)$" }, "UtcDateTimeEncoded": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" }, "CallListContactId": { "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" }, "LeadPhoneId": { "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" }, "E164PhoneNumber": { "type": "string", "pattern": "^\\+[1-9]\\d{1,14}$" }, "LeadStoredText": { "type": "string", "maxLength": 65536 }, "CallListCustomFieldValue": { "type": "string", "maxLength": 4096 } }, "type": "object", "anyOf": [ { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "#/$defs/CallListId" }, "name": { "$ref": "#/$defs/ShortText" }, "defaultTimezone": { "$ref": "#/$defs/IanaTimeZone" }, "customFieldNames": { "type": "array", "items": { "$ref": "#/$defs/ShortText" } }, "systemType": { "anyOf": [ { "anyOf": [ { "type": "string", "enum": [ "sequence_tasks" ] } ] }, { "type": "null" } ] }, "contactCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "name", "defaultTimezone", "customFieldNames", "systemType", "contactCount", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|name|defaultTimezone|customFieldNames|systemType|contactCount|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "name", "defaultTimezone", "customFieldNames", "systemType", "contactCount", "createdAt", "updatedAt" ] } } }, "pagination": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "totalPages": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currentPage": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "pageSize": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasNextPage": { "type": "boolean" }, "hasPreviousPage": { "type": "boolean" } }, "required": [ "total", "totalPages", "currentPage", "pageSize", "offset", "hasNextPage", "hasPreviousPage" ], "patternProperties": { "^(?!(?:total|totalPages|currentPage|pageSize|offset|hasNextPage|hasPreviousPage)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "total", "totalPages", "currentPage", "pageSize", "offset", "hasNextPage", "hasPreviousPage" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "type": "object", "properties": { "id": { "$ref": "#/$defs/CallListId" }, "name": { "$ref": "#/$defs/ShortText" }, "defaultTimezone": { "$ref": "#/$defs/IanaTimeZone" }, "customFieldNames": { "type": "array", "items": { "$ref": "#/$defs/ShortText" } }, "systemType": { "anyOf": [ { "anyOf": [ { "type": "string", "enum": [ "sequence_tasks" ] } ] }, { "type": "null" } ] }, "contactCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "name", "defaultTimezone", "customFieldNames", "systemType", "contactCount", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|name|defaultTimezone|customFieldNames|systemType|contactCount|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "name", "defaultTimezone", "customFieldNames", "systemType", "contactCount", "createdAt", "updatedAt" ] } }, { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "#/$defs/CallListContactId" }, "callListId": { "$ref": "#/$defs/CallListId" }, "leadId": { "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" } ] }, "leadPhoneId": { "anyOf": [ { "$ref": "#/$defs/LeadPhoneId" }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "not_called", "queued", "in_progress", "called", "completed", "skipped", "callback", "dnc", "failed" ] }, "phoneNumber": { "$ref": "#/$defs/E164PhoneNumber" }, "firstName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "emailAddress": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "companyName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "companyWebsiteUrl": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "jobTitle": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "personalLinkedInUrl": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "companyLinkedInUrl": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "locality": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "region": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "country": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "$ref": "#/$defs/IanaTimeZone" }, { "type": "null" } ] }, "customFieldValues": { "type": "object", "additionalProperties": true }, "assignedUserId": { "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" } ] }, "callAttempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lastCallId": { "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" } ] }, "lastDisposition": { "anyOf": [ { "type": "string", "enum": [ "booked_meeting", "connected", "voicemail", "no_answer", "not_interested", "callback", "wrong_number", "dnc", "gatekeeper", "ai_gatekeeper", "busy", "failed" ] }, { "type": "null" } ] }, "lastAttemptAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "nextEligibleAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "callListId", "leadId", "leadPhoneId", "status", "phoneNumber", "firstName", "lastName", "emailAddress", "companyName", "companyWebsiteUrl", "jobTitle", "personalLinkedInUrl", "companyLinkedInUrl", "locality", "region", "country", "timezone", "customFieldValues", "assignedUserId", "callAttempts", "lastCallId", "lastDisposition", "lastAttemptAt", "nextEligibleAt", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|callListId|leadId|leadPhoneId|status|phoneNumber|firstName|lastName|emailAddress|companyName|companyWebsiteUrl|jobTitle|personalLinkedInUrl|companyLinkedInUrl|locality|region|country|timezone|customFieldValues|assignedUserId|callAttempts|lastCallId|lastDisposition|lastAttemptAt|nextEligibleAt|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "callListId", "leadId", "leadPhoneId", "status", "phoneNumber", "firstName", "lastName", "emailAddress", "companyName", "companyWebsiteUrl", "jobTitle", "personalLinkedInUrl", "companyLinkedInUrl", "locality", "region", "country", "timezone", "customFieldValues", "assignedUserId", "callAttempts", "lastCallId", "lastDisposition", "lastAttemptAt", "nextEligibleAt", "createdAt", "updatedAt" ] } } }, "pagination": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "totalPages": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currentPage": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "pageSize": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasNextPage": { "type": "boolean" }, "hasPreviousPage": { "type": "boolean" } }, "required": [ "total", "totalPages", "currentPage", "pageSize", "offset", "hasNextPage", "hasPreviousPage" ], "patternProperties": { "^(?!(?:total|totalPages|currentPage|pageSize|offset|hasNextPage|hasPreviousPage)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "total", "totalPages", "currentPage", "pageSize", "offset", "hasNextPage", "hasPreviousPage" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "type": "object", "properties": { "imported": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "numbersImported": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "skipped": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "imported", "numbersImported", "skipped" ], "patternProperties": { "^(?!(?:imported|numbersImported|skipped)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "imported", "numbersImported", "skipped" ] } }, { "type": "object", "properties": { "imported": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "numbersImported": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "skipped": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "totalRecords": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "sourceName": { "$ref": "#/$defs/ShortText" } }, "required": [ "imported", "numbersImported", "skipped", "totalRecords", "sourceName" ], "patternProperties": { "^(?!(?:imported|numbersImported|skipped|totalRecords|sourceName)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "imported", "numbersImported", "skipped", "totalRecords", "sourceName" ] } }, { "type": "object", "properties": { "callListId": { "$ref": "#/$defs/CallListId" }, "deletedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "callListId", "deletedAt" ], "patternProperties": { "^(?!(?:callListId|deletedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "callListId", "deletedAt" ] } } ] }, { "type": "object" } ] }, { "type": "object", "properties": { "data": { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "#/$defs/CallListId" }, "name": { "$ref": "#/$defs/ShortText" }, "defaultTimezone": { "$ref": "#/$defs/IanaTimeZone" }, "customFieldNames": { "type": "array", "items": { "$ref": "#/$defs/ShortText" } }, "systemType": { "anyOf": [ { "anyOf": [ { "type": "string", "enum": [ "sequence_tasks" ] } ] }, { "type": "null" } ] }, "contactCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "name", "defaultTimezone", "customFieldNames", "systemType", "contactCount", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|name|defaultTimezone|customFieldNames|systemType|contactCount|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "name", "defaultTimezone", "customFieldNames", "systemType", "contactCount", "createdAt", "updatedAt" ] } } }, "pagination": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "totalPages": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currentPage": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "pageSize": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasNextPage": { "type": "boolean" }, "hasPreviousPage": { "type": "boolean" } }, "required": [ "total", "totalPages", "currentPage", "pageSize", "offset", "hasNextPage", "hasPreviousPage" ], "patternProperties": { "^(?!(?:total|totalPages|currentPage|pageSize|offset|hasNextPage|hasPreviousPage)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "total", "totalPages", "currentPage", "pageSize", "offset", "hasNextPage", "hasPreviousPage" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "type": "object", "properties": { "id": { "$ref": "#/$defs/CallListId" }, "name": { "$ref": "#/$defs/ShortText" }, "defaultTimezone": { "$ref": "#/$defs/IanaTimeZone" }, "customFieldNames": { "type": "array", "items": { "$ref": "#/$defs/ShortText" } }, "systemType": { "anyOf": [ { "anyOf": [ { "type": "string", "enum": [ "sequence_tasks" ] } ] }, { "type": "null" } ] }, "contactCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "name", "defaultTimezone", "customFieldNames", "systemType", "contactCount", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|name|defaultTimezone|customFieldNames|systemType|contactCount|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "name", "defaultTimezone", "customFieldNames", "systemType", "contactCount", "createdAt", "updatedAt" ] } }, { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "#/$defs/CallListContactId" }, "callListId": { "$ref": "#/$defs/CallListId" }, "leadId": { "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" } ] }, "leadPhoneId": { "anyOf": [ { "$ref": "#/$defs/LeadPhoneId" }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "not_called", "queued", "in_progress", "called", "completed", "skipped", "callback", "dnc", "failed" ] }, "phoneNumber": { "$ref": "#/$defs/E164PhoneNumber" }, "firstName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "lastName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "emailAddress": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "companyName": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "companyWebsiteUrl": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "jobTitle": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "personalLinkedInUrl": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "companyLinkedInUrl": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "locality": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "region": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "country": { "anyOf": [ { "$ref": "#/$defs/LeadStoredText" }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "$ref": "#/$defs/IanaTimeZone" }, { "type": "null" } ] }, "customFieldValues": { "type": "object", "additionalProperties": true }, "assignedUserId": { "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" } ] }, "callAttempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "lastCallId": { "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" } ] }, "lastDisposition": { "anyOf": [ { "type": "string", "enum": [ "booked_meeting", "connected", "voicemail", "no_answer", "not_interested", "callback", "wrong_number", "dnc", "gatekeeper", "ai_gatekeeper", "busy", "failed" ] }, { "type": "null" } ] }, "lastAttemptAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "nextEligibleAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "callListId", "leadId", "leadPhoneId", "status", "phoneNumber", "firstName", "lastName", "emailAddress", "companyName", "companyWebsiteUrl", "jobTitle", "personalLinkedInUrl", "companyLinkedInUrl", "locality", "region", "country", "timezone", "customFieldValues", "assignedUserId", "callAttempts", "lastCallId", "lastDisposition", "lastAttemptAt", "nextEligibleAt", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|callListId|leadId|leadPhoneId|status|phoneNumber|firstName|lastName|emailAddress|companyName|companyWebsiteUrl|jobTitle|personalLinkedInUrl|companyLinkedInUrl|locality|region|country|timezone|customFieldValues|assignedUserId|callAttempts|lastCallId|lastDisposition|lastAttemptAt|nextEligibleAt|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "callListId", "leadId", "leadPhoneId", "status", "phoneNumber", "firstName", "lastName", "emailAddress", "companyName", "companyWebsiteUrl", "jobTitle", "personalLinkedInUrl", "companyLinkedInUrl", "locality", "region", "country", "timezone", "customFieldValues", "assignedUserId", "callAttempts", "lastCallId", "lastDisposition", "lastAttemptAt", "nextEligibleAt", "createdAt", "updatedAt" ] } } }, "pagination": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "totalPages": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currentPage": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "pageSize": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "offset": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "hasNextPage": { "type": "boolean" }, "hasPreviousPage": { "type": "boolean" } }, "required": [ "total", "totalPages", "currentPage", "pageSize", "offset", "hasNextPage", "hasPreviousPage" ], "patternProperties": { "^(?!(?:total|totalPages|currentPage|pageSize|offset|hasNextPage|hasPreviousPage)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "total", "totalPages", "currentPage", "pageSize", "offset", "hasNextPage", "hasPreviousPage" ] } } }, "required": [ "items", "pagination" ], "patternProperties": { "^(?!(?:items|pagination)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "items", "pagination" ] } }, { "type": "object", "properties": { "imported": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "numbersImported": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "skipped": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "imported", "numbersImported", "skipped" ], "patternProperties": { "^(?!(?:imported|numbersImported|skipped)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "imported", "numbersImported", "skipped" ] } }, { "type": "object", "properties": { "imported": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "numbersImported": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "skipped": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "totalRecords": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "sourceName": { "$ref": "#/$defs/ShortText" } }, "required": [ "imported", "numbersImported", "skipped", "totalRecords", "sourceName" ], "patternProperties": { "^(?!(?:imported|numbersImported|skipped|totalRecords|sourceName)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "imported", "numbersImported", "skipped", "totalRecords", "sourceName" ] } }, { "type": "object", "properties": { "callListId": { "$ref": "#/$defs/CallListId" }, "deletedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "callListId", "deletedAt" ], "patternProperties": { "^(?!(?:callListId|deletedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "callListId", "deletedAt" ] } } ] }, { "not": { "type": "object" } } ] } }, "required": [ "data" ], "additionalProperties": false } ] } ``` ### Underlying API operations - `dialerCallLists.list`: `GET /v1/workspaces/:workspaceId/dialer/call-lists` - `dialerCallLists.get`: `GET /v1/workspaces/:workspaceId/dialer/call-lists/:callListId` - `dialerCallLists.create`: `POST /v1/workspaces/:workspaceId/dialer/call-lists` - `dialerCallLists.update`: `PATCH /v1/workspaces/:workspaceId/dialer/call-lists/:callListId` - `dialerCallLists.duplicate`: `POST /v1/workspaces/:workspaceId/dialer/call-lists/:callListId/duplicate` - `dialerCallLists.delete`: `DELETE /v1/workspaces/:workspaceId/dialer/call-lists/:callListId` - `dialerCallContacts.list`: `GET /v1/workspaces/:workspaceId/dialer/call-lists/:callListId/contacts` - `dialerCallContacts.importCsv`: `POST /v1/workspaces/:workspaceId/dialer/call-lists/:callListId/contacts/import` - `dialerCallContacts.importAttioList`: `POST /v1/workspaces/:workspaceId/dialer/call-lists/:callListId/contacts/import-attio`