Agentforge — Social Media Ads Designer (fal Gpt-image-1 + Composer Overlay,…

The workflow JSON

Copy or download the full n8n JSON below. Paste it into a new n8n workflow, add your credentials, activate. Full import guide →

{
  "name": "AgentForge \u2014 Social Media Ads Designer (FAL gpt-image-1 + composer overlay, single + bulk)",
  "nodes": [
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "generate-social-ads",
        "responseMode": "responseNode",
        "options": {}
      },
      "id": "webhook-social-ads",
      "name": "Webhook \u00b7 /generate-social-ads",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 1.1,
      "position": [
        200,
        360
      ]
    },
    {
      "parameters": {
        "jsCode": "// ============================================================\n// SOCIAL ADS \u2014 Fan out: 1 item per (ad spec \u00d7 variation index)\n// ============================================================\n// Trusts user_id (JWT-verified server-side) but NOTHING else.\n// Builds a prompt that asks gpt-image-1 to leave text zones\n// EMPTY \u2014 the composer route overlays the real text downstream.\n//\n// Picks the FAL endpoint based on whether reference images are\n// provided:\n//   \u2022 Has hero / extras \u2192 fal-ai/gpt-image-1/edit-image/byok\n//   \u2022 Otherwise         \u2192 fal-ai/gpt-image-1/text-to-image/byok\n// ============================================================\n\nconst body = $json.body || $json;\n\nif (!body.user_id) throw new Error('Missing user_id \u2014 call via /api/social-ads/generate.');\nif (!Array.isArray(body.items) || body.items.length === 0) {\n  throw new Error('Missing items[].');\n}\n\nconst PLATFORM_SIZES = {\n  'instagram-post':     { w: 1080, h: 1080, aspect: '1:1 square',         fal_size: '1024x1024' },\n  'instagram-story':    { w: 1080, h: 1920, aspect: '9:16 vertical',      fal_size: '1024x1536' },\n  'facebook-post':      { w: 1200, h: 630,  aspect: '1.91:1 landscape',   fal_size: '1536x1024' },\n  'linkedin-post':      { w: 1200, h: 627,  aspect: '1.91:1 landscape',   fal_size: '1536x1024' },\n  'youtube-thumbnail':  { w: 1280, h: 720,  aspect: '16:9 landscape',     fal_size: '1536x1024' },\n  'whatsapp-status':    { w: 1080, h: 1920, aspect: '9:16 vertical',      fal_size: '1024x1536' },\n  'newspaper-ad':       { w: 1500, h: 1100, aspect: '1.36:1 landscape',   fal_size: '1536x1024' }\n};\n\nconst CATEGORY_GUIDE = {\n  'doctor':               'Professional medical visual. Blue and white palette. Doctor portrait (white coat + stethoscope) on the right third. Service icons row (checkup, appointment, medicine). Calm clinical background blur. Trust-building, hygienic.',\n  'hospital-clinic':      'Modern hospital visual. Clean blue/teal palette. Building hero or interior reception. Reassuring professional feel.',\n  'restaurant-food':      'Appetizing food visual. Warm orange/red palette. Top-down hero food shot or plated dish photo. Mouth-watering, vibrant.',\n  'real-estate':          'Modern real estate visual. Premium grey/blue palette. House or building hero on a serving tray or skyline. Clean aspirational.',\n  'gift-shop':            'Festive colorful gift shop visual. Confetti, gift box illustrations, festival theme. Bright cheerful palette.',\n  'hotel':                'Luxury hotel visual. Dark warm brown/gold background. Three-photo collage center (room, pool, dining). Premium resort feel.',\n  'jewellery':            'Premium jewellery visual. Dark velvet or jewel-tone background. Subtle sparkle. Product hero center. Luxury showroom.',\n  'fashion-boutique':     'Editorial magazine layout. Model in outfit (if hero provided). Seasonal collection feel.',\n  'industrial-steel':     'Bold industrial visual. Multi-panel grid layout. Infrastructure imagery (bridges, buildings, elephant for strength). Earth tones with red/yellow accents.',\n  'education-coaching':   'Bright optimistic coaching visual. Blue + yellow palette. Student photo or success symbol. Trust-building.',\n  'salon-spa':            'Soft pastel pink/peach salon visual. Elegant. Model with styled hair or spa setup. Calming luxe feel.',\n  'automobile-servicing': 'Bold dark blue or black garage background with red/yellow accents. Car or bike hero on a lift or in service bay (use hero image if provided). Industrial mechanic-trust feel. Tools or service-bay details in soft focus.',\n  'gym-fitness':          'High-energy dark gym background. Athlete or equipment hero. Bold red/orange accents.',\n  'wedding-planner':      'Elegant rose-gold / blush palette. Couple silhouette or floral mandap. Romantic.',\n  'travel-tours':         'Vibrant destination hero (beach, mountain, monument). Sky-blue + sunshine palette.',\n  'pooja-store':          'Warm orange / saffron palette. Diya, brass items, marigold. Devotional traditional.',\n  'general-business':     'Modern business visual. Clean professional layout. Brand-color accent. Hero product/service photo.'\n};\n\nconst STYLE_GUIDE = {\n  'modern':           'modern flat design, generous whitespace, subtle gradients',\n  'luxury':           'dark premium palette, gold accents, soft glow lighting',\n  'festive':          'bright celebratory colors, confetti / floral motifs, joyful',\n  'minimal':          'monochrome or two-tone palette, lots of whitespace, restrained',\n  'bold-industrial':  'high-contrast bold palette, strong red / yellow / black, gritty texture',\n  'traditional':      'ethnic ornamental motifs, warm spice palette, classical'\n};\n\nfunction buildPrompt(spec, varIdx) {\n  const size = PLATFORM_SIZES[spec.platform];\n  const catDesc = CATEGORY_GUIDE[spec.business_category] || CATEGORY_GUIDE['general-business'];\n  const styleDesc = STYLE_GUIDE[spec.style_theme] || STYLE_GUIDE['modern'];\n  const hasHero = Boolean(spec.hero_image_url);\n\n  return `\nROLE: Senior social-media ad designer.\nGOAL: Create ONE ${size.aspect} background composition (${size.w}x${size.h}) for the ${spec.platform} platform. Variation ${varIdx + 1} of ${spec.variations}.\n\n========================================================\n  CATEGORY DIRECTION\n========================================================\n${catDesc}\n\n========================================================\n  STYLE\n========================================================\n${styleDesc}\n${spec.color_palette ? `Honor brand colors: ${spec.color_palette}` : ''}\n\n========================================================\n  CRITICAL \u2014 TEXT ZONES MUST BE EMPTY\n========================================================\nDO NOT render any text, headlines, taglines, prices, phone numbers, business names, lorem ipsum, or watermarks anywhere on the image.\nReserve these zones EMPTY / blurred / neutral so that text overlays can be composited later:\n  \u2022 Top-left corner (18% width \u00d7 14% height) \u2014 clean, calm \u2014 LOGO will go here\n  \u2022 Top-right corner (18% \u00d7 18%) \u2014 clean, calm \u2014 OFFER BADGE will go here\n  \u2022 Bottom 10% strip \u2014 clean, gently darker \u2014 CONTACT info will go here\n  \u2022 Center 60% width \u2014 leave a clean band where the headline will be overlaid\n\n========================================================\n  HERO REFERENCE\n========================================================\n${hasHero ? '- A hero image is provided as a reference. Use it as the primary visual subject (product / person / building). Preserve brand-critical features faithfully.' : '- No hero provided \u2014 synthesize a category-appropriate professional photo.'}\n\n========================================================\n  RULES\n========================================================\n1. Single photograph composition \u2014 NO collages / split frames.\n2. NO TEXT of any kind. NO labels, NO prices, NO URLs, NO Lorem Ipsum.\n3. NO logos baked in.\n4. Photo-realistic where appropriate (real estate, food, automobile); editorial where appropriate (fashion, jewellery).\n\n${spec.custom_instruction ? `EXTRA INSTRUCTION: \"${spec.custom_instruction}\"` : ''}\n\nReturn one image at ${size.fal_size}.\n`.trim();\n}\n\nconst out = [];\nfor (const item of body.items) {\n  const size = PLATFORM_SIZES[item.platform] || PLATFORM_SIZES['instagram-post'];\n  const variations = Math.max(1, Math.min(4, Number(item.variations) || 1));\n\n  // Reference images for the edit-image endpoint.\n  const refs = [\n    item.hero_image_url,\n    ...(Array.isArray(item.extra_image_urls) ? item.extra_image_urls : [])\n  ].filter(Boolean);\n  const hasRefs = refs.length > 0;\n  // FAL endpoint pick:\n  //   With refs \u2192 edit-image (keeps hero faithful)\n  //   Without   \u2192 text-to-image\n  const falEndpoint = hasRefs\n    ? 'https://fal.run/fal-ai/gpt-image-1/edit-image/byok'\n    : 'https://fal.run/fal-ai/gpt-image-1/text-to-image/byok';\n\n  for (let v = 0; v < variations; v++) {\n    out.push({\n      json: {\n        user_id: body.user_id,\n        batch_id: body.batch_id || null,\n        generation_id: item.generation_id,\n        variation_index: v,\n        total_variations: variations,\n        platform: item.platform,\n        fal_size: size.fal_size,\n        fal_endpoint: falEndpoint,\n        has_refs: hasRefs,\n        reference_urls: refs,\n        final_w: size.w,\n        final_h: size.h,\n        language: item.language,\n        category: item.business_category,\n        // pass through every text + url field for the composite stage\n        business_name: item.business_name,\n        main_headline: item.main_headline,\n        tagline: item.tagline,\n        offer_text: item.offer_text,\n        contact_info: item.contact_info,\n        logo_url: item.logo_url,\n        hero_image_url: item.hero_image_url,\n        extra_image_urls: item.extra_image_urls || [],\n        master_prompt: buildPrompt(item, v)\n      }\n    });\n  }\n}\n\nif (!out.length) throw new Error('Fan-out produced 0 items.');\nreturn out;\n"
      },
      "id": "fan-out",
      "name": "Fan out: spec \u00d7 variations",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        420,
        360
      ]
    },
    {
      "parameters": {
        "batchSize": 1,
        "options": {}
      },
      "id": "split-batches",
      "name": "Split In Batches (1 / image)",
      "type": "n8n-nodes-base.splitInBatches",
      "typeVersion": 3,
      "position": [
        660,
        360
      ]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "={{ $json.fal_endpoint }}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "=Key {{ $env.FAL_KEY }}"
            },
            {
              "name": "Content-Type",
              "value": "application/json"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={\n  \"prompt\":         {{ JSON.stringify($json.master_prompt) }},\n  \"image_size\":     {{ JSON.stringify($json.fal_size) }},\n  \"num_images\":     1,\n  \"openai_api_key\": {{ JSON.stringify($env.OPENAI_API_KEY) }}\n  {{ $json.has_refs ? ', \"image_urls\": ' + JSON.stringify($json.reference_urls) : '' }}\n}",
        "options": {
          "timeout": 180000
        }
      },
      "id": "fal-gpt-image",
      "name": "FAL \u00b7 gpt-image-1 (BYOK)",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        900,
        360
      ],
      "continueOnFail": true
    },
    {
      "parameters": {
        "jsCode": "// ============================================================\n// FAL gpt-image-1 returns:\n//   { images: [{ url, content_type, width, height }], ... }\n// We pass the URL straight to the composite route \u2014 no temp\n// upload needed, FAL URLs are publicly fetchable for ~24h.\n// ============================================================\n\nconst resp = $json;\nconst meta = $('Fan out: spec \u00d7 variations').itemMatching($itemIndex)?.json\n          || $('Fan out: spec \u00d7 variations').item.json;\n\n// HTTP node error path (continueOnFail) may surface as { error } / { detail }\nif (resp?.error || resp?.detail) {\n  return [{\n    json: {\n      ...meta,\n      ok: false,\n      error_message: 'FAL error: ' + JSON.stringify(resp.error || resp.detail).slice(0, 400)\n    }\n  }];\n}\n\nconst images = resp?.images || resp?.data?.images || [];\nconst first = images[0];\nif (!first?.url) {\n  return [{\n    json: {\n      ...meta,\n      ok: false,\n      error_message: 'FAL returned no image. Raw: ' + JSON.stringify(resp).slice(0, 400)\n    }\n  }];\n}\n\nreturn [{\n  json: {\n    ...meta,\n    ok: true,\n    base_image_url: first.url,\n    fal_seed: resp.seed || null\n  }\n}];\n"
      },
      "id": "extract-fal-result",
      "name": "Extract FAL Result",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        1140,
        360
      ]
    },
    {
      "parameters": {
        "conditions": {
          "options": {
            "caseSensitive": true,
            "typeValidation": "loose"
          },
          "conditions": [
            {
              "id": "ok-check",
              "leftValue": "={{ $json.ok }}",
              "rightValue": true,
              "operator": {
                "type": "boolean",
                "operation": "true",
                "singleValue": true
              }
            }
          ],
          "combinator": "and"
        },
        "options": {}
      },
      "id": "if-success",
      "name": "IF \u00b7 fal ok?",
      "type": "n8n-nodes-base.if",
      "typeVersion": 2,
      "position": [
        1380,
        360
      ]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "={{ $env.APP_URL }}/api/social-ads/composite",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "X-Internal-Secret",
              "value": "={{ $env.INTERNAL_COMPOSITE_SECRET }}"
            },
            {
              "name": "Content-Type",
              "value": "application/json"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={\n  \"generation_id\":   {{ JSON.stringify($json.generation_id) }},\n  \"user_id\":         {{ JSON.stringify($json.user_id) }},\n  \"variation_index\": {{ Number($json.variation_index) }},\n  \"base_image_url\":  {{ JSON.stringify($json.base_image_url) }},\n  \"logo_url\":        {{ JSON.stringify($json.logo_url) }},\n  \"business_name\":   {{ JSON.stringify($json.business_name) }},\n  \"main_headline\":   {{ JSON.stringify($json.main_headline) }},\n  \"tagline\":         {{ JSON.stringify($json.tagline) }},\n  \"offer_text\":      {{ JSON.stringify($json.offer_text) }},\n  \"contact_info\":    {{ JSON.stringify($json.contact_info) }},\n  \"language\":        {{ JSON.stringify($json.language) }},\n  \"platform\":        {{ JSON.stringify($json.platform) }}\n}",
        "options": {
          "timeout": 90000
        }
      },
      "id": "call-composite",
      "name": "Call /api/social-ads/composite",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        1620,
        260
      ],
      "continueOnFail": true
    },
    {
      "parameters": {
        "jsCode": "// Collect the composite route's output_url, prepare to aggregate.\nconst resp = $json;\nconst meta = $('Extract FAL Result').item.json;\nif (!resp?.success || !resp?.output_url) {\n  return [{ json: { ...meta, ok: false, error_message: resp?.error || 'composite failed' } }];\n}\nreturn [{\n  json: {\n    user_id: meta.user_id,\n    batch_id: meta.batch_id,\n    generation_id: meta.generation_id,\n    variation_index: meta.variation_index,\n    total_variations: meta.total_variations,\n    platform: meta.platform,\n    output_url: resp.output_url,\n    ok: true\n  }\n}];\n"
      },
      "id": "post-composite-collect",
      "name": "Collect composite result",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        1860,
        260
      ]
    },
    {
      "parameters": {
        "jsCode": "// ============================================================\n// Aggregate: group all variation outputs by generation_id and\n// emit one PATCH per generation row.\n// ============================================================\nconst items = $input.all().map((i) => i.json).filter((j) => j.ok);\nconst byGen = new Map();\nfor (const it of items) {\n  const arr = byGen.get(it.generation_id) || [];\n  arr.push(it);\n  byGen.set(it.generation_id, arr);\n}\nconst out = [];\nfor (const [gid, arr] of byGen) {\n  arr.sort((a, b) => a.variation_index - b.variation_index);\n  out.push({\n    json: {\n      generation_id: gid,\n      batch_id: arr[0]?.batch_id || null,\n      user_id: arr[0]?.user_id,\n      output_urls: arr.map((a) => a.output_url),\n      output_url: arr[0]?.output_url || null,\n      total_variations: arr[0]?.total_variations || arr.length\n    }\n  });\n}\nreturn out;\n"
      },
      "id": "aggregate-per-generation",
      "name": "Aggregate per generation_id",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        660,
        600
      ]
    },
    {
      "parameters": {
        "method": "PATCH",
        "url": "={{ $env.SUPABASE_URL }}/rest/v1/generations?id=eq.{{ $json.generation_id }}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "=Bearer {{ $env.SUPABASE_SERVICE_ROLE_KEY }}"
            },
            {
              "name": "apikey",
              "value": "={{ $env.SUPABASE_SERVICE_ROLE_KEY }}"
            },
            {
              "name": "Content-Type",
              "value": "application/json"
            },
            {
              "name": "Prefer",
              "value": "return=minimal"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={\n  \"status\": \"completed\",\n  \"output_url\":  {{ JSON.stringify($json.output_url) }},\n  \"output_urls\": {{ JSON.stringify($json.output_urls) }}\n}",
        "options": {
          "timeout": 30000
        }
      },
      "id": "patch-generations-success",
      "name": "Generations \u2192 completed",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        900,
        600
      ]
    },
    {
      "parameters": {
        "jsCode": "// Build one final aggregate payload for the response.\nconst items = $input.all().map((i) => i.json);\nreturn [{\n  json: {\n    success: true,\n    generation_ids: items.map((i) => i.generation_id),\n    batch_id: items[0]?.batch_id || null,\n    outputs: items.map((i) => ({\n      generation_id: i.generation_id,\n      output_urls: i.output_urls\n    }))\n  }\n}];\n"
      },
      "id": "build-response",
      "name": "Build aggregate response",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        1140,
        600
      ]
    },
    {
      "parameters": {
        "respondWith": "json",
        "responseBody": "={{ JSON.stringify($json) }}",
        "options": {}
      },
      "id": "respond-success",
      "name": "Respond Success",
      "type": "n8n-nodes-base.respondToWebhook",
      "typeVersion": 1.1,
      "position": [
        1380,
        600
      ]
    },
    {
      "parameters": {
        "method": "PATCH",
        "url": "={{ $env.SUPABASE_URL }}/rest/v1/generations?id=eq.{{ $json.generation_id }}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "=Bearer {{ $env.SUPABASE_SERVICE_ROLE_KEY }}"
            },
            {
              "name": "apikey",
              "value": "={{ $env.SUPABASE_SERVICE_ROLE_KEY }}"
            },
            {
              "name": "Content-Type",
              "value": "application/json"
            },
            {
              "name": "Prefer",
              "value": "return=minimal"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={\n  \"status\": \"failed\",\n  \"error_message\": {{ JSON.stringify($json.error_message || 'unknown failure') }}\n}",
        "options": {
          "timeout": 30000
        }
      },
      "id": "patch-generations-failed",
      "name": "Generations \u2192 failed",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        1620,
        460
      ]
    }
  ],
  "connections": {
    "Webhook \u00b7 /generate-social-ads": {
      "main": [
        [
          {
            "node": "Fan out: spec \u00d7 variations",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Fan out: spec \u00d7 variations": {
      "main": [
        [
          {
            "node": "Split In Batches (1 / image)",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Split In Batches (1 / image)": {
      "main": [
        [
          {
            "node": "Aggregate per generation_id",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "FAL \u00b7 gpt-image-1 (BYOK)",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "FAL \u00b7 gpt-image-1 (BYOK)": {
      "main": [
        [
          {
            "node": "Extract FAL Result",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Extract FAL Result": {
      "main": [
        [
          {
            "node": "IF \u00b7 fal ok?",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "IF \u00b7 fal ok?": {
      "main": [
        [
          {
            "node": "Call /api/social-ads/composite",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "Generations \u2192 failed",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Call /api/social-ads/composite": {
      "main": [
        [
          {
            "node": "Collect composite result",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Collect composite result": {
      "main": [
        [
          {
            "node": "Split In Batches (1 / image)",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Aggregate per generation_id": {
      "main": [
        [
          {
            "node": "Generations \u2192 completed",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Generations \u2192 completed": {
      "main": [
        [
          {
            "node": "Build aggregate response",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Build aggregate response": {
      "main": [
        [
          {
            "node": "Respond Success",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

About this workflow

AgentForge — Social Media Ads Designer (FAL gpt-image-1 + composer overlay, single + bulk). Uses httpRequest. Webhook trigger; 13 nodes.

Source: https://github.com/agentforgeindia/aiagentforge/blob/822c9683e77e7c8ec29ec6435e1affcc78fa94e0/n8n-workflows/social-ads-agent.json — original creator credit. Request a take-down →

More AI & RAG workflows → · Browse all categories →

Related workflows

Workflows that share integrations, category, or trigger type with this one. All free to copy and import.