Skip to main content
The official verified Poof node for n8n lets you remove backgrounds without writing any code.

​
Getting Started

The Poof node is a verified n8n node — it’s available directly in the node picker, no installation required.
  1. Open your n8n instance
  2. Search for “Poof” in the node picker
  3. Drag the Poof node onto your canvas

​
Configuration

​
Add Credentials

  1. Go to Credentials → Add Credential
  2. Search for “Poof API”
  3. Enter your API key from dash.poof.bg
  4. Save

​
Basic Usage

​
Remove Background Node

1

Add the Poof Node

Search for “Poof” in the nodes panel and drag it onto your canvas.
2

Select Credentials

Choose your Poof API credentials.
3

Configure Input

Set the input source:
  • Binary Data — From a previous node (e.g., HTTP Request, Read File)
  • URL — Direct image URL
4

Set Options

Configure output format, size, and background color as needed.

​
Node Options

If your installed version of the node shows different labels, refer to the API values in the Remove Background reference: size is full, preview, medium or hd; channels is rgba, rgb or alpha.

​
Example Workflows

​
E-commerce Product Photos

Automatically process product images from a folder:
  1. Read Binary Files: Watch a folder for new images
  2. Poof: Remove background, output as PNG
  3. Write Binary Files: Save to processed folder

​
API Endpoint

Create an API that removes backgrounds on demand:
  1. Webhook: Accept POST with image
  2. Poof: Process the image
  3. Respond: Return processed image

​
Bulk Processing with Spreadsheet

Process images listed in a Google Sheet:
  1. Google Sheets: Read rows with image URLs
  2. HTTP Request: Download each image
  3. Poof: Remove backgrounds
  4. Google Drive: Upload results

​
Airtable Integration

Process images attached to Airtable records:
  1. Airtable Trigger: When record created/updated
  2. HTTP Request: Download attachment
  3. Poof: Remove background
  4. Airtable Update: Add processed image to record

​
Working with Binary Data

The Poof node outputs binary data. To use it:

​
Save to File

​
Upload to Cloud

​
Return via API

​
Convert to Base64

​
Error Handling

Add an Error Trigger node to handle failures:
Common errors:
  • 401 — Check your API credentials
  • 402 — Out of credits
  • 429 — Rate limited (per-minute limit for your plan), add a Wait node

​
Rate Limiting

Each plan has a requests-per-minute limit (Free 4, Basic 8, Pro 12, Mega 40, Ultra 100, Giga 200). Keep the batch size at or below your plan’s limit and wait 60 seconds between batches. For example, on the Free plan:
See Rate Limit Exceeded for the full table.

​
Check Account Balance

Use the Get Account operation to check credits before processing:

​
Tips

Use Preview size for testing — It’s faster while you’re building your workflow. Every successful request costs 1 credit regardless of size.
Set up error notifications — Connect failed executions to Slack or email so you know when something goes wrong.
Batch your operations — Process images in groups no larger than your plan’s per-minute limit, with a 60-second wait between groups, to avoid rate limits.