Skip to content
Spectra.fm Docs

n8n

Connect Spectra.fm to n8n for self-hosted, privacy-focused workflow 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/project/YOUR_PROJECT_ID/export

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”

Webhook Trigger

Section titled “Webhook Trigger”
Webhook → HTTP Request (Spectra) → Slack
  1. Webhook - Receive trigger from your app
  2. HTTP Request - Export screenshots
  3. Slack - Notify team of new exports

Scheduled Export

Section titled “Scheduled Export”
Schedule Trigger → HTTP Request (Spectra) → S3
  1. Schedule Trigger - Run daily/weekly
  2. HTTP Request - Export screenshots
  3. S3 - Upload to your bucket

GitHub Integration

Section titled “GitHub Integration”
GitHub Trigger → HTTP Request (Spectra) → GitHub (Comment)
  1. GitHub Trigger - On new release
  2. HTTP Request - Export screenshots
  3. GitHub - Comment on release with links

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/project/{{ $json.projectId }}/export

Next Steps

Section titled “Next Steps”