n8n-nodes-taboola

This is an n8n community node that integrates with the Taboola Backstage API. It allows you to manage your Taboola advertising campaigns, campaign items, accounts, and reports directly from n8n workflows.

Table of Contents

• Installation
• Credentials
• Resources & Operations
• Usage
• Compatibility
• License

Installation

Community Node (Recommended)

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Select Install a community node
4. Enter n8n-nodes-taboola
5. Confirm the installation

Manual Installation

1. Clone this repository:

   git clone https://github.com/your-repo/n8n-nodes-taboola.git
   cd n8n-nodes-taboola
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Link to your n8n installation:

   npm link
   cd /path/to/your/n8n
   npm link n8n-nodes-taboola
   

5. Restart n8n. The Taboola node will appear in the node list.

Docker

If you are running n8n with Docker, add the following to your docker-compose.yml environment:

environment:
  - N8N_COMMUNITY_PACKAGES=n8n-nodes-taboola

Credentials

This node uses the Taboola Backstage API OAuth2 Client Credentials flow for authentication.

You will need:

Field	Description
Client ID	Provided by your Taboola account manager
Client Secret	Provided by your Taboola account manager

The node automatically requests an access token from https://backstage.taboola.com/backstage/oauth/token using your credentials. Tokens are valid for 12 hours.

To set up credentials in n8n:

1. Go to Credentials in the n8n sidebar
2. Click Add Credential
3. Search for Taboola API
4. Enter your Client ID and Client Secret
5. Click Save

Resources & Operations

Account

Operation	Description
Get All	Retrieve all advertiser/publisher accounts you have access to

Campaign

Operation	Description
Create	Create a new campaign with name, branding text, CPC, spending limit, and optional targeting
Get	Retrieve a single campaign by ID
Get All	Retrieve all campaigns for an account
Update	Update an existing campaign (name, CPC, spending limit, status, dates, delivery model)
Delete	Delete a campaign by ID

Campaign creation fields:

• Campaign Name (required)
• Brand Text (required)
• CPC - Cost Per Click (required)
• Spending Limit
• Spending Limit Model (Entire / Monthly / Daily)
• Start Date / End Date
• Active status
• Daily Ad Delivery Model (Accelerated / Balanced / Strict)
• Marketing Objective (Brand Awareness / Drive Website Traffic / Online Purchases / Lead Generation)
• Country Targeting (comma-separated country codes)
• Platform Targeting (Desktop / Mobile / Tablet)

Campaign Item

Operation	Description
Create	Create a new campaign item (ad) with a landing page URL, title, and thumbnail
Get All	Retrieve all items for a campaign
Update	Update an existing item (title, URL, thumbnail, active status)
Delete	Delete a campaign item by ID

Report

Operation	Description
Campaign Summary	Get a campaign summary report grouped by day, week, or month
Top Campaign Content	Get the top campaign content report (top 1,000 items)

Report parameters:

• Dimension (Day / Week / Month)
• Start Date (required, YYYY-MM-DD)
• End Date (required, YYYY-MM-DD)
• Campaign ID (optional filter)

Usage

Example: Get All Campaigns

1. Add a Taboola node to your workflow
2. Select your Taboola API credentials
3. Set Resource to Campaign
4. Set Operation to Get All
5. Enter your Account ID
6. Execute the node

Example: Create a Campaign

1. Add a Taboola node to your workflow
2. Select your Taboola API credentials
3. Set Resource to Campaign
4. Set Operation to Create
5. Enter your Account ID
6. Fill in the campaign name, brand text, and CPC
7. Optionally configure spending limits, dates, and targeting
8. Execute the node

Example: Generate a Report

1. Add a Taboola node to your workflow
2. Select your Taboola API credentials
3. Set Resource to Report
4. Set Operation to Campaign Summary
5. Enter your Account ID, start date, end date, and dimension
6. Execute the node

Compatibility

• n8n version: 1.0.0 or later
• Node.js version: 22 or later

API Reference

This node is built on the Taboola Backstage API v1.0.

• Base URL: https://backstage.taboola.com/backstage/api/1.0
• Authentication: Client Credentials Flow

License

MIT