Skip to main content
The official Figranium n8n community node (n8n-nodes-figranium) lets you trigger tasks, inspect execution history, and manage schedules from within any n8n workflow.

​
Installation

  1. In n8n, go to Settings > Community Nodes.
  2. Click Install a community node.
  3. Enter n8n-nodes-figranium and agree to the risks.
  4. Restart n8n if prompted.

​
Credentials

The node authenticates using a Figranium API credential.
  1. Go to Credentials and click Add Credential.
  2. Search for Figranium API.
  3. Fill in the two fields:
FieldDescription
Base URLThe URL of your Figranium instance, e.g. http://localhost:11345. No trailing slash.
API KeyYour API key from Figranium Settings > System. Sent as the x-api-key header on every request.

​
Node Overview

The Figranium node exposes three top-level resources, each with one or more operations.
ResourceOperations
TaskExecute, List
ExecutionList
ScheduleList, Get Status, Set Schedule, Delete Schedule, Describe Schedule, Get Scheduler Status

​
Task

​
Execute

Runs a saved task and returns its result as JSON. Parameters
ParameterTypeRequiredDescription
TaskDropdownYesThe task to run. Populated automatically from your Figranium server.
VariablesKey-value collectionNoRuntime variable overrides. Each entry has a Name and a Value. These override any defaults defined in the task itself.
API call: POST /api/tasks/{taskId}/api Output: The full JSON response from the task execution — typically includes result data, status, and metadata. Example use case: A webhook fires when a new order arrives. The Figranium node executes a “Scrape Competitor Price” task, passing product_url as a variable extracted from the webhook payload. The result flows into a database insert node.

​
List

Returns all tasks available on the connected Figranium server. Parameters: None beyond the credential. API call: GET /api/tasks/list Output: One item per task, each containing at minimum a name and id field.

​
Execution

​
List

Returns a summary of all past task executions recorded by Figranium. Parameters: None beyond the credential. API call: GET /api/executions/list Output: An array of execution records. Each record typically includes the task ID, execution timestamp, status, and a result summary.

​
Schedule

​
List

Returns all tasks that currently have a schedule configured. Parameters: None beyond the credential. API call: GET /api/schedules Output: An array of schedule objects, one per scheduled task.

​
Get Status

Returns the schedule configuration and the next calculated run time for a specific task. Parameters
ParameterTypeRequiredDescription
Task IDStringYesThe ID of the task whose schedule you want to inspect.
API call: GET /api/schedules/{taskId}/status Output: A single object containing the schedule definition and the nextRun timestamp.

​
Set Schedule

Creates or updates the schedule for a task. Two scheduling modes are available: Frequency (a structured picker) or Cron Expression (a raw cron string). Parameters
ParameterTypeRequiredDescription
Task IDStringYesThe ID of the task to schedule.
EnabledBooleanYesWhether the schedule should be active immediately. Default: true.
Schedule ModeOptionsYesFrequency (Interval) or Cron Expression.
When Schedule Mode is “Frequency”
ParameterTypeShown whenDescription
FrequencyOptionsAlwaysEvery N Minutes, Daily, Weekly, or Monthly.
Interval (Minutes)NumberFrequency = Every N MinutesHow often to run, in minutes. Default: 60.
HourNumberFrequency = Daily / Weekly / MonthlyHour of day to run (0–23). Default: 9.
MinuteNumberFrequency = Daily / Weekly / MonthlyMinute of hour to run (0–59). Default: 0.
Days of WeekMulti-selectFrequency = WeeklyOne or more days (Sunday–Saturday). Default: Monday.
Day of MonthNumberFrequency = MonthlyDay of the month to run (1–31). Default: 1.
When Schedule Mode is “Cron Expression”
ParameterTypeDescription
Cron ExpressionStringA standard 5-field cron expression: minute hour day month weekday. Example: 0 9 * * 1 runs every Monday at 09:00.
API call: POST /api/schedules/{taskId} Output: The saved schedule object.

​
Delete Schedule

Disables and removes the schedule from a task. The task itself is not deleted. Parameters
ParameterTypeRequiredDescription
Task IDStringYesThe ID of the task whose schedule should be removed.
API call: DELETE /api/schedules/{taskId} Output: A confirmation object.

​
Describe Schedule

Validates a schedule configuration and returns a human-readable preview (e.g. next run times) without saving anything. Useful for testing cron expressions before committing them. Parameters
ParameterTypeRequiredDescription
Task IDStringYesThe task context for the preview.
Schedule ModeOptionsYesFrequency (Interval) or Cron Expression. Same sub-fields as Set Schedule.
API call: POST /api/schedules/{taskId}/describe Output: A preview object describing when the schedule would fire.

​
Get Scheduler Status

Returns the overall health and status of the Figranium task scheduler — not tied to any specific task. Parameters: None beyond the credential. API call: GET /api/schedules/status/all Output: A status object for the scheduler engine (e.g. running, paused, number of active schedules).

​
Troubleshooting

​
Task dropdown is empty

  • Confirm your Base URL is reachable from the n8n host (not just from your browser).
  • Verify the API Key is valid.
  • Check n8n logs for 401 Unauthorized or 404 Not Found errors during the “load options” phase.

​
Connection refused in Docker

If both n8n and Figranium run in Docker on the same machine, localhost in the Base URL will resolve to the n8n container itself. Use your host machine’s internal IP or the Docker bridge IP (e.g. http://172.17.0.1:11345) instead.

​
Variables not overriding task defaults

Variable Name values are case-sensitive and must match the variable names defined in the task exactly.