n8n-nodes-meta-ads

This is an n8n community node for Meta Ads (Facebook/Instagram Marketing API). It allows you to retrieve campaign data from your Meta Ad Accounts.

Features

• Campaign Management:
  • Get Many: Retrieve a list of campaigns from a specific Ad Account.
  • Get: Retrieve details of a specific campaign by its ID.

Prerequisites

To use this node, you need:

1. A Meta Developer account.
2. A Meta App with the Marketing API product added.
3. A System User Access Token or User Access Token with ads_read permissions.
4. Your Ad Account ID (formatted as act_<ID>).

Installation

For Users (via n8n UI)

1. Go to Settings > Community Nodes in your n8n instance.
2. Click on Install a new node.
3. Enter n8n-nodes-meta-ads as the npm package name.
4. Agree to the risks and click Install.

For Developers (Manual)

1. Clone or copy this repository to your local machine.
2. Navigate to the project directory:

   cd n8n-nodes-meta-ads
   

3. Install dependencies:

   npm install
   

4. Build the project:

   npm run build
   

5. Link the package to your local n8n installation:

   npm link
   # Then go to your n8n custom nodes directory (usually ~/.n8n/custom)
   cd ~/.n8n/custom
   npm link n8n-nodes-meta-ads
   

6. Restart n8n.

Credentials

Meta Ads API

• Access Token: Your Meta Marketing API access token.
• Ad Account ID: The ID of your ad account (e.g., act_123456789).

Usage

1. Add the Meta Ads node to your workflow.
2. Select the Meta Ads API credentials.
3. Choose the Resource (currently only Campaign is supported).
4. Choose the Operation:
   • Get Many: Returns a list of campaigns. You can set a limit or return all.
   • Get: Requires a Campaign ID to fetch a specific campaign's details.

Development

• npm run build: Compiles the TypeScript code and copies icons to the dist folder.
• npm run dev: Starts the TypeScript compiler in watch mode.
• npm run lint: Runs ESLint to check for code quality issues.