Skip to content
Spectra.fm Docs

n8n

Connect Spectra.fm to n8n for self-hosted, privacy-focused visual automation.

Setup

Section titled “Setup”

1. Add HTTP Request Node

Section titled “1. Add HTTP Request Node”

In your n8n workflow, add an HTTP Request node.

2. Configure the Node

Section titled “2. Configure the Node”
SettingValue
MethodPOST
URLhttps://api.spectra.fm/v1/projects/YOUR_PROJECT_ID/exports

3. Authentication

Section titled “3. Authentication”
  1. Select Header Auth under Authentication
  2. Create new credentials:
    • Name: X-API-Key
    • Value: Your Spectra.fm API key

4. Request Body

Section titled “4. Request Body”

Enable Send Body and configure:

SettingValue
Body Content TypeJSON
Specify BodyUsing JSON
{
  "combinations": [
    {"locale": "en", "theme": "light"},
    {"locale": "en", "theme": "dark"}
  ]
}

Example Workflows

Section titled “Example Workflows”

Product launch → social kit

Section titled “Product launch → social kit”
Webhook → HTTP Request (Spectra) → Slack
  1. Webhook - Trigger on release or launch event
  2. HTTP Request - Export OG, LinkedIn, and Instagram assets
  3. Slack - Share export links with the team

Blog publish → header + OG

Section titled “Blog publish → header + OG”
Schedule Trigger → HTTP Request (Spectra) → S3
  1. Schedule Trigger - Poll CMS or run on publish
  2. HTTP Request - Export blog hero + OG image
  3. S3 - Store assets by slug

Certificates → personalized batch

Section titled “Certificates → personalized batch”
Webhook Trigger → HTTP Request (Spectra) → S3
  1. Webhook - Receive completion data (name, date, course)
  2. HTTP Request - Export certificates using content variations
  3. S3 - Save and notify

Using Expressions

Section titled “Using Expressions”

Reference data from previous nodes:

{
  "combinations": [
    {"locale": "{{ $json.locale }}", "theme": "{{ $json.theme }}"}
  ]
}

Or use the expression editor for the URL:

https://api.spectra.fm/v1/projects/{{ $json.projectId }}/exports
Section titled “Async Export Flow (Recommended)”

  1. HTTP Request (GET) — export options
    URL: https://api.spectra.fm/v1/projects/{{ $json.projectId }}/exports/options

  2. HTTP Request (POST) — create export
    URL: https://api.spectra.fm/v1/projects/{{ $json.projectId }}/exports
    Response includes exportId.

  3. Wait — 2–5 seconds

  4. HTTP Request (GET) — poll status
    URL: https://api.spectra.fm/v1/projects/{{ $json.projectId }}/exports/{{ $json.exportId }}
    Loop until status is completed.

  5. HTTP Request (GET) — list artifacts
    URL: https://api.spectra.fm/v1/projects/{{ $json.projectId }}/exports/{{ $json.exportId }}/artifacts

Use downloadUrl from the artifacts response, or call:

https://api.spectra.fm/v1/projects/{{ $json.projectId }}/exports/download?objectKey={{ $json.objectKey }}&filename={{ $json.filename }}

Next Steps

Section titled “Next Steps”