smartlead_delete_folder

Remove a folder from Smart Delivery by specifying its folder ID, enabling users to maintain organized email marketing campaigns.

Instructions

Delete a folder from Smart Delivery.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`folder_id`	Yes	ID of the folder to delete

Implementation Reference

src/handlers/smartDelivery.ts:1213-1252 (handler)

The core handler function that validates the input arguments using isDeleteFolderParams and executes the DELETE API request to the Smart Delivery endpoint `/spam-test/folder/{folder_id}` to delete the specified folder.

async function handleDeleteFolder(
  args: unknown, 
  apiClient: AxiosInstance,
  withRetry: <T>(operation: () => Promise<T>, context: string) => Promise<T>
) {
  if (!isDeleteFolderParams(args)) {
    throw new McpError(
      ErrorCode.InvalidParams,
      'Invalid arguments for smartlead_delete_folder'
    );
  }

  try {
    const smartDeliveryClient = createSmartDeliveryClient(apiClient);
    const { folder_id } = args;
    
    const response = await withRetry(
      async () => smartDeliveryClient.delete(`/spam-test/folder/${folder_id}`),
      'delete folder'
    );

    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(response.data, null, 2),
        },
      ],
      isError: false,
    };
  } catch (error: any) {
    return {
      content: [{ 
        type: 'text', 
        text: `API Error: ${error.response?.data?.message || error.message}` 
      }],
      isError: true,
    };
  }
}

src/tools/smartDelivery.ts:564-578 (schema)

MCP tool schema definition with input schema specifying the required folder_id parameter as integer.

export const DELETE_FOLDER_TOOL: CategoryTool = {
  name: 'smartlead_delete_folder',
  description: 'Delete a folder from Smart Delivery.',
  category: ToolCategory.SMART_DELIVERY,
  inputSchema: {
    type: 'object',
    properties: {
      folder_id: {
        type: 'integer',
        description: 'ID of the folder to delete',
      },
    },
    required: ['folder_id'],
  },
};

src/types/smartDelivery.ts:423-430 (schema)

Type guard function used for input validation, confirming args is an object containing a numeric folder_id.

export function isDeleteFolderParams(args: unknown): args is DeleteFolderParams {
  return (
    typeof args === 'object' &&
    args !== null &&
    'folder_id' in args &&
    typeof (args as DeleteFolderParams).folder_id === 'number'
  );
}

src/index.ts:217-219 (registration)
Registers the smartDeliveryTools array (including smartlead_delete_folder) with the tool registry if the smartDelivery category is enabled by license.
```
if (enabledCategories.smartDelivery) {
  toolRegistry.registerMany(smartDeliveryTools);
}
```
src/handlers/smartDelivery.ts:122-124 (registration)
Switch case in handleSmartDeliveryTool that routes calls to the specific delete folder handler.
```
case 'smartlead_delete_folder': {
  return handleDeleteFolder(args, apiClient, withRetry);
}
```

Smartlead Simplified MCP Server