brandiz

Brandiz.io for n8n: add posts, have the studio design posters and make reels from the business's own website, upload pictures and video, and schedule them, as a step or as a tool for n8n's AI Agent.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Brandiz.io

Documentation

n8n-nodes-brandiz

The Brandiz.io node for n8n. Brandiz.io is a business's own social media studio: it reads the business's website and makes on-brand posters and reels from it, checks every word, and schedules them on the business's connected channels.

With this node a workflow (or n8n's AI Agent) can:

  • read the business: its brief, voice, language and facts, the strategist's ideas, the calendar, the package and the results;
  • see what's working in the business's niche, and have the strategist write the business's own version of a post that worked;
  • add a post's words and have the studio design the poster or make the reel;
  • upload pictures and video, and post the business's own files with a caption;
  • schedule a post on its channels (next free time, now, or a set time) and stop it;
  • pass on a reviewer's decision (say, a client in your portal): approve, ask for changes with a note, or disapprove, on the version they saw, with who decided.

Posts wait for the owner's Approve in Brandiz.io, unless the API key was made with Let it schedule and post for me (which also lets it approve and disapprove).

Install

In n8n, go to Settings → Community nodes → Install, type n8n-nodes-brandiz and install it. See n8n's guide to installing community nodes for other ways.

Connect your business

  1. In Brandiz.io, open Connect AI (in the sidebar) and tap Make an API key.
  2. Give it a name (for example "n8n"). Tick Let it schedule and post for me only if posts from n8n may go out without your Approve.
  3. Copy the key. It starts with bzapi_ and is shown once.
  4. In n8n, add a Brandiz API credential and paste the key into API Key. Leave Base URL as https://www.brandiz.io.

n8n checks the key when you save the credential. You can disconnect the key in Brandiz.io at any time; it stops working at once.

What it does

Resource Operation What it does
Post Create Adds a new post's words (kind, recipe, title, slides, caption, picture idea; a reel's look, length, voice, music and captions). Nothing is made or spent yet.
Post Create Own Post Posts the business's own pictures or video with a caption: files from the input item (uploaded first) or media IDs, the channels, when, a first comment and a title. Uses no post from the package.
Post Get One post.
Post Get Many Posts, newest first, filtered by state (one item per post).
Post Update Changes a post's caption or title.
Post Make Poster Has the studio design the post's poster or carousel. Uses one post from the package the first time.
Post Make Reel Has the studio direct and render the reel (look, length, voice, music, captions). Uses one reel from the package.
Post Get Status How the studio is coming along: being_made, the steps so far and the last one.
Post Schedule Picks the channels (empty: every connected channel that can take it) and when: the next free posting time, now, or a set time at least 5 minutes ahead.
Post Stop Stops a post from going out.
Media Upload Uploads a picture or video from the input item's binary field, or from a public link (Brandiz.io fetches it, up to 100 MB).
Media Download Downloads a post's picture or video into a binary field.
Channel Get Many The connected social accounts (one item per channel).
Business Get The business's name, website, language, brief and facts.
Calendar Get What goes out when, for the days ahead (up to 60).
Package Get What's used and what's left this month.
Result Get How the posts did in the last 30 days: reach, likes, comments, engagement and the top posts (each with times_usual when it did far better than the account's usual).
Idea Get Many The strategist's poster and reel ideas (one item per idea).
What's Working Get Many Posts that did far better than their account's usual in the business's niche this month (one item per post): the account, the network, the link, times_usual, likes, comments, views, why it works and the move behind it, with niche and more_with_a_package.
What's Working Make Our Version The strategist writes the business's own idea built the way that post works (its own offer and words, never the post's) onto its Ideas board. Uses nothing from the package; five a day.

Every post operation outputs the post's own fields (id, title, kind, state, caption, slides, media, schedule, being_made and more) with anything the answer adds, such as message or approved.

Files

  • Files up to 4 MB go through Brandiz.io's server. Bigger files go straight to Brandiz.io's storage with a one-time link, then Brandiz.io checks them.
  • An own post takes one video, or 1 to 10 pictures.
  • Media → Download takes a media id, or the url from a post's media list.

A typical workflow

  1. Brandiz → Business → Get, so the words use the business's own facts.
  2. Brandiz → Post → Create with the post's words.
  3. Brandiz → Post → Make Poster with {{ $json.id }}.
  4. Wait a few minutes, then Brandiz → Post → Get Status until being_made is false.
  5. Brandiz → Post → Schedule on the next free posting time.

The studio checks every word: numbers, prices and dates must come from the business's facts.

Use it as a tool for n8n's AI Agent

The node can be used as a tool: add an AI Agent node, then add Brandiz under its tools and let the model define the parameters it needs. For a post's Slides, the model can give one JSON list of { headline, body }. A good instruction for the agent:

Read the business first (Business → Get). Use only its facts for numbers, prices and dates. After Make Poster or Make Reel, check Get Status before you schedule. Tell the owner the post waits for their Approve in Brandiz.io unless it was scheduled.

On a self-hosted n8n, community nodes may show up as AI Agent tools only when n8n runs with N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true.

When something goes wrong

The node shows Brandiz.io's own message and what to do next. Turn on Continue On Fail to get the message as an item (error, description, code, httpCode) and carry on with the next items.

  • unauthorized: the key was disconnected or mistyped. Make a new one in Brandiz.io.
  • limit: this month's package is used up.
  • not_ready: the studio is still making the post. Check Get Status and try again.
  • rate_limited: each key may make 120 requests a minute. Wait and try again.

Links

Version history

  • 0.1.0: first release.

License

MIT

Discussion