Automate ImageKit media management workflows in n8n using the official community node @imagekit/n8n-nodes-imagekit. Upload, organize, search, update, and manage files and folders in your ImageKit media library directly from your n8n workflows, no custom code required.
The node source code is available on GitHub.
Node Features
The node covers the full ImageKit API. Upload files from binary data or remote URLs, organize media (create, move, copy, rename, delete files and folders), search assets with filters and Lucene-like syntax, manage file metadata and custom metadata fields, run bulk operations (delete, add/remove tags), purge CDN cache, manage account origins and URL endpoints, and trigger workflows automatically from ImageKit webhook events with HMAC signature verification.
Prerequisites
The node requires n8n version 1.85.x or later for self-hosted instances.
Installation
Self-hosted n8n
Install the node from the community nodes UI: go to Settings > Community Nodes, click Install, enter @imagekit/n8n-nodes-imagekit, and click Install. Restart n8n if required.
You can also install community nodes from the command line or from environment variables. Refer to the n8n community nodes installation guide for more details.
Authentication
ImageKit API credentials
Sign in to your ImageKit dashboard, go to Developer Options > API Keys, and copy your Private Key. In n8n, go to Settings > Credentials, create a new credential of type ImageKit API, paste your private key, and save.
Webhook credentials
For webhook triggers, create a separate credential of type ImageKit Webhook API with the webhook signing secret used to verify incoming ImageKit webhook payloads.
You can find this in the Webhooks section of your ImageKit dashboard.
Resources and operations
The ImageKit node uses the v1 API and provides complete coverage of the ImageKit API. Select a Resource and Operation from the dropdowns in the node configuration panel.
- File. Upload, update, get details, delete, copy, move, rename, and bulk operations (bulk delete, bulk add/remove tags, bulk remove AI tags).
- Asset. List and search assets with filters, pagination, sorting, and Lucene-like search syntax.
- Folder. Create, delete, copy, move, rename folders and check bulk job status.
- File Version. List, get, delete, and restore file versions.
- Metadata. Get metadata by file ID or from a URL.
- Custom Metadata Fields. Create, list, update, and delete custom metadata field definitions.
- Purge Cache. Purge CDN cache and check purge status.
- Account. Get account usage statistics.
- Account Origin. Create, list, get, update, and delete origins.
- Account URL Endpoint. Create, list, get, update, and delete URL endpoints.
- Saved Extension. Create, list, get, update, and delete saved extensions.
Refer to the ImageKit API reference for detailed request parameters and response formats for each operation.
Webhook trigger
The ImageKit Trigger node starts workflows when events occur in your ImageKit account. Configure it to listen for specific event types such as file uploads, updates, and video processing completions.
Setting up webhook triggers
- Add the ImageKit Trigger node to your workflow.
- Select which events you want to listen for using the Events dropdown.
- Configure the ImageKit Webhook API credential with your webhook signing secret.
- Activate the workflow to register the webhook URL.
- Copy the webhook URL and add it in the Webhooks section of your ImageKit dashboard.
Signature verification
The trigger node automatically verifies incoming webhook signatures to ensure deliveries are authentic and haven't been tampered with. This is enabled by default and we recommend keeping it on in production. You can disable it with the Verify Signature toggle during development if needed.
For more details on webhook events and payloads, refer to the ImageKit Webhooks documentation.
Sample workflow templates
Ready-to-use n8n workflow templates to get started quickly. Import any template into your n8n instance by copying its JSON and pasting it into Workflows > Import from URL / JSON.
Browse all templates in the sample-workflows directory on GitHub.
Alert Slack when ImageKit storage or bandwidth usage exceeds threshold
Runs on an hourly schedule, fetches your current billing-month usage stats from the ImageKit usage API, and compares each metric (storage, bandwidth, video units, extension units, original cache) against a configurable threshold. If any metric is breached, a single consolidated Slack message is sent with per-metric values and progress bars. Otherwise the workflow exits silently. View template →
Auto-unpublish ImageKit assets that fail NSFW check
Listens for the ImageKit file.created webhook, downloads the new asset, and sends it to a GPT-4o vision model (via OpenRouter) that returns a structured is_nsfw/confidence/reason verdict. If the asset is flagged, it is immediately unpublished in ImageKit. Clean assets pass through untouched. View template →
Purge ImageKit CDN cache on Contentful publish and notify via Slack
Triggered by a Contentful Asset.publish webhook, the workflow recursively scans the payload for every ik.imagekit.io URL and fires a cache purge request per URL. A Slack message is posted per URL with the purge request ID, and the workflow polls ImageKit until each purge completes, updating the corresponding Slack message. View template →
Have a workflow of your own? Contributions are welcome. Open a pull request against the sample-workflows directory on GitHub to share it with the community.