delete_account
Permanently remove an email account from the Instantly.ai platform. This action deletes all account data, removes it from campaigns, and cannot be reversed.
Instructions
🚨 PERMANENTLY delete an email account. CANNOT UNDO!
This action:
Removes the account from all campaigns
Deletes all account data
Cannot be reversed
Confirm with user before executing!
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Implementation Reference
- The main async handler function that executes the delete_account tool by encoding the email and calling client.delete('/accounts/{email}') API endpoint. Returns JSON success response.
async def delete_account(params: DeleteAccountInput) -> str: """ 🚨 PERMANENTLY delete an email account. CANNOT UNDO! This action: - Removes the account from all campaigns - Deletes all account data - Cannot be reversed Confirm with user before executing! """ client = get_client() email_encoded = quote(params.email, safe="") result = await client.delete(f"/accounts/{email_encoded}") return json.dumps({"success": True, "deleted": params.email, **result}, indent=2) - Pydantic BaseModel schema for DeleteAccountInput, validates the required 'email' field with description warning of permanence.
class DeleteAccountInput(BaseModel): """Input for deleting an account. ⚠️ PERMANENT - CANNOT UNDO!""" model_config = ConfigDict(str_strip_whitespace=True, extra="ignore") email: str = Field(..., description="Email to DELETE PERMANENTLY") - src/instantly_mcp/server.py:68-75 (registration)TOOL_ANNOTATIONS dictionary entry registering MCP annotations for delete_account tool: destructiveHint=True and confirmationRequiredHint=True.
# Account tools "list_accounts": {"readOnlyHint": True}, "get_account": {"readOnlyHint": True}, "create_account": {"destructiveHint": False}, "update_account": {"destructiveHint": False}, "manage_account_state": {"destructiveHint": False}, "delete_account": {"destructiveHint": True, "confirmationRequiredHint": True}, - src/instantly_mcp/tools/accounts.py:223-230 (registration)Includes delete_account in ACCOUNT_TOOLS list, which is used by get_all_tools() for dynamic tool registration in the MCP server.
ACCOUNT_TOOLS = [ list_accounts, get_account, create_account, update_account, manage_account_state, delete_account, ]