n8n-nodes-tukigrowth

n8n community node for TukiGrowth API.

TukiGrowth is a marketing strategy and content planning platform. This node allows you to interact with organizations, clients, portfolio items, strategy resources, content, CRM, ecommerce, and more.

Installation

In n8n Community Nodes

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-tukigrowth
4. Click Install

Manual Installation

cd ~/.n8n/custom
npm install n8n-nodes-tukigrowth

Credentials

To use this node, you need a TukiGrowth API key:

1. Log in to your TukiGrowth account
2. Go to Settings > API Keys
3. Create a new API key
4. Copy the key (starts with tg_)

In n8n:

1. Go to Credentials
2. Click Add Credential
3. Search for "TukiGrowth API"
4. Paste your API key
5. Save

AI Agent Support

This node can be used as a tool in n8n AI Agent workflows. Simply add it to your AI Agent's tools to enable the agent to interact with TukiGrowth resources.

Output Options

Use the Options field in the node to control response verbosity:

• Simplify Output (default: true): for List and Get operations, returns a reduced payload with the most useful fields when available (_id, id, name, title, slug, status, type, email). Disable it to get the full API response.
• Debug Mode (default: false): includes request debug details under _debug in each output item.

API v1 Alignment Notes

• Auth header is X-API-Key
• Base path pattern is /api/v1/organizations/{orgId}/clients/{clientId}/...
• offer-units was replaced by portfolio-items
• Strategy scope now uses scopeType (brand or portfolio_item) and portfolioItemId

Supported Resources & Operations

Resource	List	Get	Create	Update	Delete
Organization	✅	✅	✅	✅	❌
Client	✅	✅	✅	✅	✅
Business Context	❌	✅	❌	✅	❌
Portfolio Item	✅	✅	✅	✅	✅
Objective	✅	✅	✅	✅	✅
Audience	✅	✅	✅	✅	✅
Pain Point	✅	✅	✅	✅	✅
Content Brief	✅	✅	✅	✅	✅
Social Media Post	✅	✅	✅	✅	✅
Website Content	✅	✅	✅	✅	✅
Asset	✅	✅	✅	✅	✅
Product	✅	✅	✅	✅	✅
Customer	✅	✅	✅	✅	✅
Order	✅	✅	✅	✅	✅
Ad Campaign	✅	✅	✅	✅	✅
Newsletter	✅	✅	✅	✅	✅
Comment	✅	❌	✅	✅	✅

Organization

Manage organizations (top-level entities).

Operation	Description
List	Get all organizations
Get	Get a single organization by ID
Create	Create a new organization
Update	Update an organization

Create/Update Fields:

• Name (required for create)
• Slug (required for create, URL-friendly identifier)
• Status (active, paused, archived)

Client

Manage clients within an organization.

Operation	Description
List	Get all clients for an organization
Get	Get a single client by ID
Create	Create a new client
Update	Update a client
Delete	Delete a client

Create Fields:

• Name (required)
• Slug (required)
• Business Type (required: ecommerce, services, mixed, other)
• Website URL (optional)
• Timezone (optional)
• Primary Language (optional)
• Channels (optional)

Portfolio Item

Manage portfolio items for a client.

Operation	Description
List	Get all portfolio items
Get	Get a portfolio item by ID
Create	Create a new portfolio item
Update	Update a portfolio item
Delete	Delete a portfolio item

Create Fields:

• Name (required)
• Description (optional)
• Category (optional)
• Status (optional)

Business Context

Manage the business context for a client (strategic information).

Operation	Description
Get	Get the business context for a client
Update	Update the business context

Update Fields:

• Value Proposition
• Target Audience
• Competitive Advantage
• Key Differentiators
• Brand Voice

Objective

Manage marketing objectives for a client.

Operation	Description
List	Get all objectives
Get	Get an objective by ID
Create	Create a new objective
Update	Update an objective
Delete	Delete an objective

Create Fields:

• Title (required)
• Type (required)
• Scope Type (optional: brand or portfolio_item)
• Portfolio Item ID (optional)
• Intent Type (optional)

Audience

Manage target audiences for a client.

Operation	Description
List	Get all audiences
Get	Get an audience by ID
Create	Create a new audience
Update	Update an audience
Delete	Delete an audience

Create Fields:

• Name (required)
• Description (optional)
• Scope Type (optional: brand or portfolio_item)
• Portfolio Item ID (optional)
• Demographics (optional)
• Pain Points (optional)
• Goals (optional)

Pain Point

Manage customer pain points for a client.

Operation	Description
List	Get all pain points
Get	Get a pain point by ID
Create	Create a new pain point
Update	Update a pain point
Delete	Delete a pain point

Create Fields:

• Title (required)
• Severity (low, medium, high, critical)
• Scope Type (optional: brand or portfolio_item)
• Portfolio Item ID (optional)
• Description (optional)

Content Brief

Manage content briefs for a client.

Operation	Description
List	Get all content briefs
Get	Get a content brief by ID
Create	Create a new content brief
Update	Update a content brief
Delete	Delete a content brief

Create Fields:

• Title (required)
• Funnel Level (awareness, consideration, conversion, retention)
• Description (optional)
• Target Keywords (optional)
• Content Type (optional)

Social Media Post

Manage social media posts for a client.

Operation	Description
List	Get all social media posts
Get	Get a social media post by ID
Create	Create a new social media post
Update	Update a social media post
Delete	Delete a social media post

Create Fields:

• Title (required)
• Channel (linkedin, twitter, instagram, facebook, tiktok, youtube)
• Content Type (post, story, reel, carousel)
• Content (optional)
• Scheduled Date (optional)

Website Content

Manage website content for a client.

Operation	Description
List	Get all website content
Get	Get website content by ID
Create	Create new website content
Update	Update website content
Delete	Delete website content

Create Fields:

• Title (required)
• Content Type (landing_page, blog_post, product_page, about_page, faq)
• Content (optional)
• URL (optional)
• Meta Description (optional)

Asset

Manage digital assets for a client.

Operation	Description
List	Get all assets
Get	Get an asset by ID
Create	Create a new asset
Update	Update an asset
Delete	Delete an asset

Create Fields:

• Name (required)
• URL (required)
• Type (image, video, document, audio, other)
• Description (optional)

Product

Manage products for a client.

Operation	Description
List	Get all products
Get	Get a product by ID
Create	Create a new product
Update	Update a product
Delete	Delete a product

Create Fields:

• Name (required)
• Description (optional)
• Price (required)
• Category (optional)
• SKU (optional)
• Variant (optional)
• Industry (optional)
• Rating (optional)
• Review Count (optional)
• Raw Content (optional)

Customer

Manage customers for a client.

Operation	Description
List	Get all customers
Get	Get a customer by ID
Create	Create a new customer
Update	Update a customer
Delete	Delete a customer

Create Fields:

• Name (required)
• Email (optional)
• Phone (optional)
• Company (optional)

Order

Manage orders for a client.

Operation	Description
List	Get all orders
Get	Get an order by ID
Create	Create a new order
Update	Update an order
Delete	Delete an order

Create Fields:

• Customer ID (required)
• Products (optional)
• Total (optional)
• Status (optional)

Ad Campaign

Manage advertising campaigns for a client.

Operation	Description
List	Get all ad campaigns
Get	Get an ad campaign by ID
Create	Create a new ad campaign
Update	Update an ad campaign
Delete	Delete an ad campaign

Create Fields:

• Name (required)
• Platform (google, facebook, instagram, linkedin, tiktok)
• Budget (optional)
• Start Date (optional)
• End Date (optional)
• Status (optional)

Newsletter

Manage newsletters for a client.

Operation	Description
List	Get all newsletters
Get	Get a newsletter by ID
Create	Create a new newsletter
Update	Update a newsletter
Delete	Delete a newsletter

Create Fields:

• Subject (required)
• Content (optional)
• Scheduled Date (optional)
• Status (optional)

Comment

Manage comments on resources.

Operation	Description
List	Get all comments
Create	Create a new comment
Update	Update a comment
Delete	Delete a comment

Create Fields:

• Body (required)
• Resource Type (optional)
• Resource ID (optional)

Update Fields:

• Body
• Is Resolved (boolean)

Example Usage

Create a Client

1. Add a TukiGrowth node to your workflow
2. Select Client as the resource
3. Select Create as the operation
4. Select the Organization
5. Fill in the required fields:
   • Name
6. Optionally add:
   • Code
   • Website
   • Industry

List Content Briefs

1. Add a TukiGrowth node
2. Select Content Brief > List
3. Select the Organization and Client
4. The node will return all content briefs for that client

Create a Social Media Post

1. Add a TukiGrowth node
2. Select Social Media Post > Create
3. Select the Organization and Client
4. Fill in:
   • Title
   • Channel (e.g., LinkedIn, Twitter)
   • Content Type (post, carousel, etc.)
   • Content

Development

This project uses Docker for builds:

# Build
docker compose run build

# Publish
docker compose run publish

License

MIT

Support

• TukiGrowth Documentation
• GitHub Issues