Automation

Zapier Integration

Connect 1FRX to Zapier and automate asset generation across 5,000+ apps. Use 1FRX actions in your Zaps to generate OG images, QR codes, invoices, certificates, and more.

Note: The 1FRX Zapier app is pending Zapier marketplace approval. In the meantime, use the HTTP webhook action to connect (see below).

Available 1FRX Zapier actions

Setup (using webhook)

1. Get your 1FRX API key

Copy your API key from 1FRX dashboard Settings.

2. Create a new Zap

  1. Go to zapier.com → Create → Create Zap
  2. Choose your trigger app (e.g., Gmail, RSS, Airtable)
  3. Set up your trigger (e.g., "New email with attachment")
  4. Test the trigger to confirm data is flowing

3. Add 1FRX action step

  1. Click + Add action
  2. Search for "Webhooks by Zapier"
  3. Choose "POST"
  4. Set URL: https://api.1frx.com/v1/tools/og-image
  5. Set Headers:

X-1FRX-Key: sk_live_your_api_key
Content-Type: application/json

4. Map data from trigger to 1FRX

In the request body, map your trigger data:

{
  "title": "Your Blog Post Title",
  "subtitle": "Optional subtitle",
  "domain": "yourblog.com",
  "accentColor": "#5ee3ff"
}

Use Zapier's dynamic field mapping to pull data from your trigger (e.g., drag the "Subject" field from Gmail into the "title" field).

5. Handle the response

The 1FRX API returns a JSON response with the image URL:

{
  "url": "https://cdn.1frx.com/og/abc123.png",
  "width": 1200,
  "height": 630,
  "expiresAt": "2026-05-16T12:00:00Z"
}

6. Use the URL in next steps

Add another action to post, email, or store the image URL. For example:

Example Zap recipes

Recipe 1: RSS to Social Media
  • Trigger: New item in RSS feed (e.g., your blog's RSS)
  • Action 1: Webhook → Call 1FRX Generate OG Image with feed item title
  • Action 2: Twitter/X → Post to Twitter with the OG image URL
  • Result: Every new blog post automatically gets posted to Twitter with a custom OG image
Recipe 2: Google Sheets to Invoices
  • Trigger: New row in Google Sheets (invoice data: client, items, amount)
  • Action 1: Webhook → Call 1FRX Create Invoice with row data
  • Action 2: Gmail → Email the invoice PDF to the client
  • Result: Add a row to a spreadsheet, invoice automatically generated and emailed
Recipe 3: Typeform to Certificates
  • Trigger: New Typeform submission (course completion form)
  • Action 1: Webhook → Call 1FRX Generate Certificate with submission data
  • Action 2: Email → Send certificate PDF to the responder
  • Result: Course completers get instant certificates emailed automatically

API endpoint reference for Zapier

Use these endpoints in your Zapier webhook actions:

Full request/response examples are in the API Reference.

Troubleshooting

Webhook returns 401 (Unauthorized)

Check that your X-1FRX-Key header is set correctly. The key should start with sk_live_.

Webhook returns 400 (Bad Request)

Verify your JSON body matches the expected format for the endpoint. Check the API Reference for required fields.

URL is returned but image appears broken

The image is hosted on 1FRX's CDN. Check that the URL starts with https://cdn.1frx.com and is accessible in your browser.

Rate limit exceeded (429)

You've hit your monthly request limit. Check your 1FRX plan and upgrade if needed.

What data does 1FRX process? Only the fields you explicitly map in your webhook body. Zapier itself may see trigger data, but 1FRX only processes the data you send in the JSON payload. Generated assets are cached for 30 days then removed.

What's next

Make Integration N8N Integration API Reference