N8N Integration

Connect 1FRX to N8N to auto-generate social images, QR codes, invoices, and certificates in your self-hosted automation workflows. Works with both N8N Cloud and self-hosted instances.

Setup

There are two ways to use 1FRX with N8N: install a dedicated community node from npm, or use the HTTP Request node for direct API access.

Option 1: N8N Community Node

Install the community node for a native 1FRX experience in N8N:

npm install n8n-nodes-1frx

After installation:

1. Restart your N8N instance
2. In N8N, click the + button to add a new node
3. Search for "1FRX" in the node list
4. Click the node to add it to your workflow
5. Enter your 1FRX API key in the Credentials panel

The node provides a native UI for selecting endpoints and configuring parameters.

Option 2: HTTP Request Node

Use N8N's built-in HTTP Request node for API access without installing a custom node:

1. Add an HTTP Request node to your workflow
2. Set Method to POST
3. Set URL to the 1FRX API endpoint (e.g., https://api.1frx.com/og-image)
4. Click Add Header and add: X-1FRX-Key with your API key value
5. Set Content-Type header to application/json
6. In the Body tab, enter your JSON payload

Example HTTP Request configuration:

POST https://api.1frx.com/og-image
Headers:
  X-1FRX-Key: your-api-key-here
  Content-Type: application/json

Body:
{
  "title": "My Article Title",
  "subtitle": "A brief description",
  "domain": "example.com",
  "accentColor": "#5ee3ff",
  "template": "gradient"
}

Example Workflows

Blog OG Image Pipeline

Automatically generate Open Graph images when new blog posts are published:

1. Start with a trigger (e.g., Webhook for blog platform, Database for CMS)
2. Add a 1FRX node (or HTTP Request node)
3. Map post title and excerpt to 1FRX parameters
4. Save the generated image URL to your database or CMS
5. Use the image URL as the featured image for social sharing

Invoice Automation

Generate branded invoices when new orders are created:

1. Trigger on new order event (Stripe, Shopify, custom webhook)
2. Extract order details (amount, customer name, date)
3. Call 1FRX invoice endpoint with order data
4. Send the generated invoice PDF via email to the customer

Event Ticket Generation

Create branded event tickets for attendees automatically:

1. Trigger on new registration (Eventbrite, Typeform, Google Forms)
2. Extract attendee details (name, email, ticket ID)
3. Call 1FRX event-ticket endpoint
4. Email the generated ticket to the attendee
5. Log ticket URL in your database

Supported Endpoints

All 1FRX endpoints are available via HTTP Request:

• https://api.1frx.com/og-image — Social media images
• https://api.1frx.com/qr-code — Dynamic QR codes
• https://api.1frx.com/invoice — Branded invoices
• https://api.1frx.com/certificate — Certificates
• https://api.1frx.com/event-ticket — Event tickets
• https://api.1frx.com/youtube-thumbnail — Video thumbnails
• https://api.1frx.com/speaker-promo — Speaker promos

Troubleshooting

Node not appearing after npm install

Restart your N8N instance and clear your browser cache. For self-hosted N8N, rebuild the Docker image if you're using containers.

401 Unauthorized errors

Verify your API key is correct in the Credentials panel. Check that your 1FRX account is active and your API key has not been rotated.

Workflow timeout

N8N has a default timeout of 3600 seconds. Image generation is typically fast (under 1 second), but if you're generating many images, consider batching requests or increasing your timeout.

HTTP Request node returns 400 Bad Request

Verify your JSON payload matches the 1FRX API schema. Check that all required fields are present and properly formatted.

FAQ

Can I use 1FRX with N8N Cloud?

Yes. Both the community node and HTTP Request approach work with N8N Cloud. Just ensure your API key is stored securely in N8N credentials.

Is the community node maintained?

The community node is maintained by the 1FRX team. Updates are released when new endpoints are added or existing ones are enhanced.

What's the difference between the community node and HTTP Request?

The community node provides a native N8N UI with parameter validation and autocomplete. The HTTP Request approach is more flexible and requires no installation, but you'll write JSON manually.

Can I batch multiple 1FRX calls in one workflow?

Yes. Use N8N's Loop node to iterate over records and call 1FRX for each one. This is useful for generating images for multiple blog posts or invoices in a single workflow execution.