# n8n Integration

## How to Import and Use <a href="#blurit-n8n-template---how-to-import-and-use" id="blurit-n8n-template---how-to-import-and-use"></a>

### Overview <a href="#overview" id="overview"></a>

The `n8n-blurit-create-task.json` template provides a complete n8n workflow that:

* Accepts media file uploads through a web form
* Authenticates with the BlurIt API
* Creates anonymization tasks with configurable blur settings
* Monitors task progress
* Downloads the processed result file

### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

* An n8n instance (cloud or self-hosted)
* A BlurIt account with API credentials
* Access to the BlurIt Developer section for API keys

### Step 1: Import the Template <a href="#step-1-import-the-template" id="step-1-import-the-template"></a>

{% file src="/files/IeNeNBLXopPgrRbHw8ur" %}

1. **Download the template file**

   * Download or copy the JSON content

2. **Import into n8n**

   * Open your n8n instance
   * Click the "+" button to create a new workflow
   * Click on the three dots menu (⋯) in the top right
   * Select "Import from file"&#x20;
   * Upload the `n8n-blurit-create-task.json` file

<div align="left"><figure><img src="/files/yoWWs22dhlb6lsiAsiju" alt="" width="343"><figcaption><p>Import the json template in your n8n Project</p></figcaption></figure></div>

Once imported, the workflow should present this :

<figure><img src="/files/WUIQNezm4Dftj55pOU03" alt=""><figcaption><p>Blurit Create Task Workflow</p></figcaption></figure>

### Step 2: Configure BlurIt Credentials <a href="#step-2-configure-blurit-credentials" id="step-2-configure-blurit-credentials"></a>

1. **Get your API credentials**

   * Log in to your BlurIt account
   * Navigate to [Blurit Developer](https://app.blurit.io/account/developer) section
   * Copy your `Client ID` and `Secret ID`

   <div align="left"><figure><img src="/files/btt6VCPPMYbzQFoaxlGg" alt="" width="563"><figcaption><p>Get your credentials from blurit app manager</p></figcaption></figure></div>

2. **Update the workflow configuration**

   * In the imported workflow, double-click the **"Set Auth Config"** node

   <div align="left"><figure><img src="/files/c3X5hQyLr98LBwLWkxu1" alt=""><figcaption></figcaption></figure></div>

   * Replace the placeholder values:
     * `[REPLACE_BY_YOUR_CLIENT_ID]` → Your actual Client ID
     * `[REPLACE_BY_YOUR_SECRET_ID]` → Your actual Secret ID

   <div align="left"><figure><img src="/files/5iaFbVQk5q5tmFA9MPqf" alt="" width="563"><figcaption><p>Set your personnal credentials</p></figcaption></figure></div>

   * The `BASE_URL` is pre-configured as `https://api.services.wassa.io`

### Step 3: Configure the Upload Form <a href="#step-3-configure-the-upload-form" id="step-3-configure-the-upload-form"></a>

The workflow includes a form trigger that generates upload URLs (this is a demo purpose, replace by your own media flow if needed) :

1. **Access form URLs**

   * Click link present in Sticky Note or Double-click the **"Upload Input File"** node

   <div align="left"><figure><img src="/files/Zri3lY6rYhY3CRFNtpSx" alt=""><figcaption></figcaption></figure></div>

   * Note the webhook ID (used in the URLs)
   * The form will be available at:
     * **Test**: `https://[your-n8n-instance]/webhook-test/[webhook-id]/n8n-form`
     * **Production**: `https://[your-n8n-instance]/webhook/[webhook-id]/n8n-form`
2. **Form configuration**

   * Form title: "Media Upload Form"
   * Description: "Upload an image or video for anonymization"
   * Accepts: Single file upload (images and videos)

   <div align="left"><figure><img src="/files/ye8Mu6tWRtGz23xLBlLR" alt=""><figcaption><p>n8n upload file form</p></figcaption></figure></div>

### Step 4: Customize Blur Settings (Optional) <a href="#step-4-customize-blur-settings-optional" id="step-4-customize-blur-settings-optional"></a>

The default configuration blurs both faces and license plates. To customize:

1. **Edit blur configuration**

   * Double-click the **"Create Blurit Task"** node

   <div align="left"><figure><img src="/files/MJSss0GsEBhH233y8SYf" alt=""><figcaption></figcaption></figure></div>

   * Modify the body parameters:
     * `activation_plates_blur`: "true" or "false"
     * `activation_faces_blur`: "true" or "false"
     * `blur_type`: JSON configuration for blur settings
2. **Example blur\_type configurations**

   ```json
   // Standard blur
   {"anonymization_type": "blur"}

   // Pixelation
   {"anonymization_type": "pixelate", "num_pixels": 7}

   // Black boxes
   {"anonymization_type": "opaque", "hex_color": "#000000"}
   ```

### Step 5: Run the Workflow <a href="#step-5-run-the-workflow" id="step-5-run-the-workflow"></a>

1. **Execute the workflow**
   * Click **"⚡️ Execute Workflow"** button\
     ![](/files/zbRuhrnnhDcafGAf4Gkn)
   * The workflow will start and wait for file upload
2. **Upload your media file**
   * Use one of the form URLs from the sticky note instructions
   * Upload an image or video file
   * Return to the n8n console (refresh if needed)
3. **Monitor progress**

   <div align="left"><figure><img src="/files/kapzIFpV0mDPsMsmFzU4" alt=""><figcaption></figcaption></figure></div>

   * The workflow will automatically:
     * Authenticate with BlurIt API
     * Create the anonymization task
     * Wait for processing (2-second intervals)
     * Check task status
     * Download the result when completed

### Step 6: Get Your Results <a href="#step-6-get-your-results" id="step-6-get-your-results"></a>

1. **Successful completion**

   * When the task succeeds, the **"Get Result File"** node will execute

   <div align="left"><figure><img src="/files/LON845R6tGXLmAEBc1Co" alt=""><figcaption></figcaption></figure></div>

   * The processed file will be available in the node's output data

   <div align="left"><figure><img src="/files/MtYxbwHiifh9UjavRE0e" alt="" width="512"><figcaption></figcaption></figure></div>

   * Click **"View"** or **"Download"** in the output section

   <div align="left"><figure><img src="/files/y7mKP3Nel3PudLUIVU4d" alt="" width="554"><figcaption></figcaption></figure></div>

2. **Handle different outcomes**
   * **Task Succeeded**: Result file is downloaded
   * **Task Failed**: Check error messages in the workflow execution
   * **Pending**: Workflow continues to wait and retry

### Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

#### Common Issues <a href="#common-issues" id="common-issues"></a>

1. **Authentication Errors**
   * Verify your Client ID and Secret ID are correct
   * Check that credentials are properly configured in "Set Auth Config"
2. **File Upload Issues**
   * Ensure the webhook URLs are accessible
   * Check file size limits (varies by n8n instance)
   * Verify supported file formats (images: JPG, PNG; videos: MP4, AVI, etc.)
3. **Task Processing Failures**
   * Check the BlurIt API status
   * Verify your account has sufficient credits
   * Review error messages in the workflow execution log
4. **Timeout Issues**
   * Large files may take longer to process
   * Consider increasing the wait time in the "Wait" node
   * Check your n8n execution timeout settings

#### Debug Tips <a href="#debug-tips" id="debug-tips"></a>

1. **Check node outputs**
   * Click on any node to see its input/output data
   * Use the "View" option to inspect JSON responses
2. **Monitor API responses**
   * Check the "Auth Get Token" output for authentication success
   * Review "Create Blurit Task" response for task creation
   * Monitor "Get Task Status" for processing updates
3. **Test with small files first**
   * Start with small image files for initial testing
   * Gradually test with larger files and videos

### API Endpoints Used <a href="#api-endpoints-used" id="api-endpoints-used"></a>

* **Authentication**: `POST /login`
* **Create Task**: `POST /innovation-service/anonymization`
* **Check Status**: `GET /innovation-service/anonymization?anonymization_job_id={id}`
* **Download Result**: `GET /innovation-service/anonymization/{output_filename}`

### Security Considerations <a href="#security-considerations" id="security-considerations"></a>

* Store API credentials securely in n8n
* Use environment variables for sensitive data in production
* Regularly rotate your API keys
* Monitor API usage from Blurit dashboard

### Support <a href="#support" id="support"></a>

For additional help:

* Blurit API Documentation: [Developer Portal](https://doc-api.blurit.io/)
* n8n Documentation: [n8n.io/docs](https://docs.n8n.io/)
* Blurit Support: Contact through your Blurit account

***

*This template provides a complete automation solution for media anonymization using the Blurit API within n8n workflows.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc-api.blurit.io/n8n-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.