create_linkedin_image_campaign

POST https://api.adspirer.ai/api/v1/tools/create_linkedin_image_campaign/execute

⚠️ STOP - DO NOT CALL THIS TOOL DIRECTLY! This tool creates REAL LinkedIn campaigns that cost REAL money. You MUST follow the MANDATORY 9-PHASE WORKFLOW below before calling this tool. ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ MANDATORY 9-PHASE WORKFLOW - MUST COMPLETE ALL PHASES WITH USER CONFIRMATION ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ PHASE 1: DISCOVERY (required) ✓ Call `get_linkedin_organizations` to get Organization ID and Account ID ✓ Call `research_business_for_linkedin_targeting` with user's website URL ✓ Ask user about their business, products, and ideal customer PHASE 2: TARGETING STRATEGY (required - present ALL options to user) ✓ Ask user which LOCATIONS to target (show common options: US, UK, Canada, EU, etc.) ✓ Present SENIORITY levels with recommendations: - Unpaid (urn:li:seniority:1), Training (urn:li:seniority:2), Entry (urn:li:seniority:3) - Senior (urn:li:seniority:4), Manager (urn:li:seniority:5), Director (urn:li:seniority:6) - VP (urn:li:seniority:7), CXO (urn:li:seniority:8), Partner (urn:li:seniority:9), Owner (urn:li:seniority:10) - Recommend for B2B: Manager, Director, VP, CXO ✓ Present ALL COMPANY SIZE tiers (use staffCountRange URNs): - 1 employee: urn:li:staffCountRange:(1,1) - 2-10: urn:li:staffCountRange:(2,10), 11-50: urn:li:staffCountRange:(11,50) - 51-200: urn:li:staffCountRange:(51,200), 201-500: urn:li:staffCountRange:(201,500) - 501-1000: urn:li:staffCountRange:(501,1000), 1001-5000: urn:li:staffCountRange:(1001,5000) - 5001-10000: urn:li:staffCountRange:(5001,10000), 10000+: urn:li:staffCountRange:(10001,2147483647) ✓ Suggest INDUSTRIES based on research ✓ GET USER CONFIRMATION on targeting before proceeding PHASE 3: CAMPAIGN OBJECTIVE (required - explain ALL options) ✓ Call `explain_linkedin_objectives` or present this table to user: | Objective | Best For | Cost | |-----------|----------|------| | WEBSITE_VISIT ⭐ | Traffic to website | $5-15 CPC | | WEBSITE_CONVERSIONS | Sign-ups, purchases | $50-200 CPA | | LEAD_GENERATION | LinkedIn lead forms | $30-100 CPL | | BRAND_AWARENESS | Reach & impressions | $8-15 CPM | | ENGAGEMENT | Likes, shares | $10-20 CPM | | VIDEO_VIEWS | Video content | $0.05-0.20 CPV | ✓ Recommend ONE objective with reasoning based on user's business ✓ GET USER CONFIRMATION on objective PHASE 4: BUDGET & SCHEDULE (required) ✓ Ask user for DAILY BUDGET (minimum $10, recommend $30-50 for testing) ✓ Ask for CAMPAIGN DURATION (minimum 7 days for learning phase) ✓ Ask for START DATE (immediate or scheduled) ✓ GET USER CONFIRMATION PHASE 5: CONVERSION TRACKING (optional but recommended) ✓ Call `list_linkedin_conversions` to check existing conversions ✓ Present existing conversions to user ✓ Ask which conversions to track (or skip if none) PHASE 6: CREATIVE ASSETS (required) ✓ Call `discover_linkedin_assets` to find existing images ✓ Present available images to user with descriptions ✓ Ask user to SELECT an existing image OR upload new one ✓ If uploading: Use `validate_and_prepare_linkedin_assets` PHASE 7: AD CREATIVE COPY (required - create 4 variations) ✓ Call `generate_linkedin_ad_creatives` to create 4 variations: 1. Problem-focused (pain point) 2. Solution-focused (benefit) 3. Social proof (results/testimonials) 4. Curiosity/question hook ✓ Present ALL 4 variations to user ✓ Each variation needs: Introductory text, Headline, CTA ✓ GET USER APPROVAL on ad copy PHASE 8: FINAL CONFIRMATION (required) ✓ Present COMPLETE CAMPAIGN SUMMARY: - Campaign name, objective, daily budget, duration - All targeting settings - Ad creative content - Landing page URL - Estimated reach and costs ✓ Ask user: "Ready to create? Type 'Yes' to proceed" ✓ DO NOT PROCEED without explicit user confirmation PHASE 9: CREATE CAMPAIGN + ALL VARIATIONS (only after all confirmations) ✓ Call this tool with Variation 1 parameters to create the campaign ✓ Then call `add_linkedin_creative` for each remaining variation (2, 3, 4) using the campaign_id ✓ Campaign is created PAUSED by default - ask user if they want to activate ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ CRITICAL RULES: 1. NEVER skip phases - complete ALL 9 phases in order 2. NEVER assume user preferences - ALWAYS ask 3. NEVER call this tool without explicit final confirmation 4. ALWAYS show all options (seniorities, company sizes, objectives) 5. ALWAYS present 4-5 ad creative variations to user BEFORE creating 6. ALWAYS create ALL approved variations (use `add_linkedin_creative` after initial creation) 7. ALWAYS present full summary before creating 8. ALWAYS provide a `creative_name` for each creative (e.g. "Campaign Name - Ad 1", "Campaign Name - Ad 2") 9. NEVER use "LinkedIn" in ad copy (introductory text, headline). LinkedIn's ad policy prohibits it. Also avoid other platform names (Facebook, Google, Instagram, etc.) Required Parameters: - campaign_name: Descriptive name (auto-suffixed with timestamp) - daily_budget: Minimum $10/day - organization_id: LinkedIn Company Page ID (from Phase 1) - introductory_text: Main ad copy (up to 600 chars) - landing_page_url: HTTPS URL - locations: List of location URNs (required) - Image source: image_urn OR asset_bundle_id (from Phase 6) Optional Parameters: - headline, call_to_action, objective - industries, seniorities, job_titles, company_sizes - start_date, end_date, total_budget Location URNs: - United States: urn:li:geo:103644278 - United Kingdom: urn:li:geo:101165590 - Canada: urn:li:geo:101174742 - Australia: urn:li:geo:101452733 - Germany: urn:li:geo:101282230 - India: urn:li:geo:102713980 Execution time: 15-30 seconds

{
  "arguments": {
    "campaign_name": "string",
    "daily_budget": 10.0,
    "organization_id": "string",
    "introductory_text": "string",
    "headline": "string",
    "landing_page_url": "https://example.com",
    "locations": [
      "string"
    ],
    "asset_bundle_id": "string",
    "image_urn": "string",
    "call_to_action": "LEARN_MORE",
    "campaign_group_id": "string",
    "campaign_group_name": "string",
    "objective": "WEBSITE_VISIT"
  }
}

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for create_linkedin_image_campaign)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "create_linkedin_image_campaign"
}

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "create_linkedin_image_campaign"
}

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "create_linkedin_image_campaign",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}