# 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_voicemail_greetings Keep the library of pre-recorded greetings a rep can drop into a prospect's voicemail: list them, register a newly uploaded one, and delete one nobody uses. Use to report which greetings exist and whether each is ready to drop, to finish an upload the person has already made, or to retire a greeting that is out of date. This does not record audio and does not drop a voicemail — dropping one is part of a live call and belongs to a human at a softphone. Only MP3 and WAV reach a carrier directly; anything else is transcoded first and cannot be dropped until its status says so. Deleting a greeting also deletes its audio. 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:manage_voicemails 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", "create_upload_intent", "finalize", "delete" ] }, "voicemailId": { "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" }, "uploadIntent": { "type": "object", "properties": { "fileName": { "type": "string", "minLength": 1, "maxLength": 255 }, "contentType": { "type": "string", "enum": [ "audio/mpeg", "audio/mp3", "audio/wav", "audio/x-wav", "audio/mp4", "audio/m4a", "audio/x-m4a", "audio/ogg", "audio/webm" ] }, "sizeBytes": { "type": "integer", "minimum": 1, "maximum": 10485760 } }, "required": [ "fileName", "contentType", "sizeBytes" ], "patternProperties": { "^(?!(?:fileName|contentType|sizeBytes)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "fileName", "contentType", "sizeBytes" ] } }, "finalize": { "type": "object", "properties": { "uploadId": { "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" }, "fileName": { "type": "string", "minLength": 1, "maxLength": 255 }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "contentType": { "type": "string", "enum": [ "audio/mpeg", "audio/mp3", "audio/wav", "audio/x-wav", "audio/mp4", "audio/m4a", "audio/x-m4a", "audio/ogg", "audio/webm" ] }, "sizeBytes": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "durationSeconds": { "type": "integer", "minimum": 0, "maximum": 120 } }, "required": [ "uploadId", "fileName", "name", "contentType", "sizeBytes" ], "patternProperties": { "^(?!(?:uploadId|fileName|name|contentType|sizeBytes|durationSeconds)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "uploadId", "fileName", "name", "contentType", "sizeBytes", "durationSeconds" ] } } }, "required": [ "workspaceId", "action" ], "patternProperties": { "^(?!(?:workspaceId|action|voicemailId|uploadIntent|finalize)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "action", "voicemailId", "uploadIntent", "finalize" ] } } ``` ### 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", "create_upload_intent", "finalize", "delete" ] }, "voicemailId": { "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" }, "uploadIntent": { "type": "object", "properties": { "fileName": { "type": "string", "minLength": 1, "maxLength": 255 }, "contentType": { "type": "string", "enum": [ "audio/mpeg", "audio/mp3", "audio/wav", "audio/x-wav", "audio/mp4", "audio/m4a", "audio/x-m4a", "audio/ogg", "audio/webm" ] }, "sizeBytes": { "type": "integer", "minimum": 1, "maximum": 10485760 } }, "required": [ "fileName", "contentType", "sizeBytes" ], "patternProperties": { "^(?!(?:fileName|contentType|sizeBytes)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "fileName", "contentType", "sizeBytes" ] } }, "finalize": { "type": "object", "properties": { "uploadId": { "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" }, "fileName": { "type": "string", "minLength": 1, "maxLength": 255 }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "contentType": { "type": "string", "enum": [ "audio/mpeg", "audio/mp3", "audio/wav", "audio/x-wav", "audio/mp4", "audio/m4a", "audio/x-m4a", "audio/ogg", "audio/webm" ] }, "sizeBytes": { "type": "integer", "minimum": 1, "maximum": 10485760 }, "durationSeconds": { "type": "integer", "minimum": 0, "maximum": 120 } }, "required": [ "uploadId", "fileName", "name", "contentType", "sizeBytes" ], "patternProperties": { "^(?!(?:uploadId|fileName|name|contentType|sizeBytes|durationSeconds)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "uploadId", "fileName", "name", "contentType", "sizeBytes", "durationSeconds" ] } } }, "required": [ "workspaceId", "action" ], "patternProperties": { "^(?!(?:workspaceId|action|voicemailId|uploadIntent|finalize)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "workspaceId", "action", "voicemailId", "uploadIntent", "finalize" ] } } ``` ### Output schema (structuredContent) ```json { "$defs": { "ShortText": { "type": "string", "minLength": 1, "maxLength": 256 }, "HttpUrl": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^https?:\\/\\/[^\\s/$.?#][^\\s]*$" }, "UtcDateTimeEncoded": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" } }, "type": "object", "anyOf": [ { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "name": { "$ref": "#/$defs/ShortText" }, "durationSeconds": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "transcodingStatus": { "type": "string", "enum": [ "not_required", "pending", "processing", "completed", "failed" ] }, "transcodingError": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "playbackUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "type": "null" } ] }, "playbackUrlExpiresAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "playbackUnavailableReason": { "anyOf": [ { "type": "string", "enum": [ "missing_object", "storage_error", "not_prepared" ] }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "name", "durationSeconds", "transcodingStatus", "transcodingError", "playbackUrl", "playbackUrlExpiresAt", "playbackUnavailableReason", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|name|durationSeconds|transcodingStatus|transcodingError|playbackUrl|playbackUrlExpiresAt|playbackUnavailableReason|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "name", "durationSeconds", "transcodingStatus", "transcodingError", "playbackUrl", "playbackUrlExpiresAt", "playbackUnavailableReason", "createdAt", "updatedAt" ] } } } }, "required": [ "items" ], "patternProperties": { "^(?!(?:items)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "items" ] } ] } }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "name": { "$ref": "#/$defs/ShortText" }, "durationSeconds": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "transcodingStatus": { "type": "string", "enum": [ "not_required", "pending", "processing", "completed", "failed" ] }, "transcodingError": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "playbackUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "type": "null" } ] }, "playbackUrlExpiresAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "playbackUnavailableReason": { "anyOf": [ { "type": "string", "enum": [ "missing_object", "storage_error", "not_prepared" ] }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "name", "durationSeconds", "transcodingStatus", "transcodingError", "playbackUrl", "playbackUrlExpiresAt", "playbackUnavailableReason", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|name|durationSeconds|transcodingStatus|transcodingError|playbackUrl|playbackUrlExpiresAt|playbackUnavailableReason|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "name", "durationSeconds", "transcodingStatus", "transcodingError", "playbackUrl", "playbackUrlExpiresAt", "playbackUnavailableReason", "createdAt", "updatedAt" ] } }, { "type": "object", "properties": { "uploadId": { "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" }, "uploadUrl": { "$ref": "#/$defs/HttpUrl" }, "method": { "anyOf": [ { "type": "string", "enum": [ "PUT" ] } ] }, "expiresAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "uploadId", "uploadUrl", "method", "expiresAt" ], "patternProperties": { "^(?!(?:uploadId|uploadUrl|method|expiresAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "uploadId", "uploadUrl", "method", "expiresAt" ] } }, { "type": "object", "properties": { "voicemailId": { "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" }, "deletedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "voicemailId", "deletedAt" ], "patternProperties": { "^(?!(?:voicemailId|deletedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "voicemailId", "deletedAt" ] } } ] }, { "type": "object" } ] }, { "type": "object", "properties": { "data": { "allOf": [ { "anyOf": [ { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "name": { "$ref": "#/$defs/ShortText" }, "durationSeconds": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "transcodingStatus": { "type": "string", "enum": [ "not_required", "pending", "processing", "completed", "failed" ] }, "transcodingError": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "playbackUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "type": "null" } ] }, "playbackUrlExpiresAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "playbackUnavailableReason": { "anyOf": [ { "type": "string", "enum": [ "missing_object", "storage_error", "not_prepared" ] }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "name", "durationSeconds", "transcodingStatus", "transcodingError", "playbackUrl", "playbackUrlExpiresAt", "playbackUnavailableReason", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|name|durationSeconds|transcodingStatus|transcodingError|playbackUrl|playbackUrlExpiresAt|playbackUnavailableReason|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "name", "durationSeconds", "transcodingStatus", "transcodingError", "playbackUrl", "playbackUrlExpiresAt", "playbackUnavailableReason", "createdAt", "updatedAt" ] } } } }, "required": [ "items" ], "patternProperties": { "^(?!(?:items)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "anyOf": [ { "type": "string", "enum": [ "items" ] } ] } }, { "type": "object", "properties": { "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "name": { "$ref": "#/$defs/ShortText" }, "durationSeconds": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "transcodingStatus": { "type": "string", "enum": [ "not_required", "pending", "processing", "completed", "failed" ] }, "transcodingError": { "anyOf": [ { "$ref": "#/$defs/ShortText" }, { "type": "null" } ] }, "playbackUrl": { "anyOf": [ { "$ref": "#/$defs/HttpUrl" }, { "type": "null" } ] }, "playbackUrlExpiresAt": { "anyOf": [ { "$ref": "#/$defs/UtcDateTimeEncoded" }, { "type": "null" } ] }, "playbackUnavailableReason": { "anyOf": [ { "type": "string", "enum": [ "missing_object", "storage_error", "not_prepared" ] }, { "type": "null" } ] }, "createdAt": { "$ref": "#/$defs/UtcDateTimeEncoded" }, "updatedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "id", "name", "durationSeconds", "transcodingStatus", "transcodingError", "playbackUrl", "playbackUrlExpiresAt", "playbackUnavailableReason", "createdAt", "updatedAt" ], "patternProperties": { "^(?!(?:id|name|durationSeconds|transcodingStatus|transcodingError|playbackUrl|playbackUrlExpiresAt|playbackUnavailableReason|createdAt|updatedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "id", "name", "durationSeconds", "transcodingStatus", "transcodingError", "playbackUrl", "playbackUrlExpiresAt", "playbackUnavailableReason", "createdAt", "updatedAt" ] } }, { "type": "object", "properties": { "uploadId": { "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" }, "uploadUrl": { "$ref": "#/$defs/HttpUrl" }, "method": { "anyOf": [ { "type": "string", "enum": [ "PUT" ] } ] }, "expiresAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "uploadId", "uploadUrl", "method", "expiresAt" ], "patternProperties": { "^(?!(?:uploadId|uploadUrl|method|expiresAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "uploadId", "uploadUrl", "method", "expiresAt" ] } }, { "type": "object", "properties": { "voicemailId": { "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" }, "deletedAt": { "$ref": "#/$defs/UtcDateTimeEncoded" } }, "required": [ "voicemailId", "deletedAt" ], "patternProperties": { "^(?!(?:voicemailId|deletedAt)$)[\\s\\S]*$": false }, "additionalProperties": true, "propertyNames": { "type": "string", "enum": [ "voicemailId", "deletedAt" ] } } ] }, { "not": { "type": "object" } } ] } }, "required": [ "data" ], "additionalProperties": false } ] } ``` ### Underlying API operations - `dialerVoicemails.list`: `GET /v1/workspaces/:workspaceId/dialer/voicemails` - `dialerVoicemails.createUploadIntent`: `POST /v1/workspaces/:workspaceId/dialer/voicemails/upload-url` - `dialerVoicemails.finalize`: `POST /v1/workspaces/:workspaceId/dialer/voicemails` - `dialerVoicemails.delete`: `DELETE /v1/workspaces/:workspaceId/dialer/voicemails/:voicemailId`