Validate And Prepare LinkedIn Assets

User provides image URLs to validate BEFORE creating LinkedIn image campaign.

Validate and prepare new image assets for LinkedIn ad campaigns.

IMPORTANT:

Call get_linkedin_organizations FIRST to get organization_id AND account_id
Include account_id when calling this tool - it’s REQUIRED for images to be discoverable later!

LinkedIn Image Requirements:

Horizontal (Sponsored Content): 1200x627 pixels
Square (Sponsored Content): 1080x1080 pixels
Vertical (Stories/Mobile): 1200x1500 pixels
Carousel cards: 1080x1080 pixels (each card)
Maximum file size: 8MB
Formats: JPEG, PNG, GIF (non-animated)

Parameters:

image_urls: List of public image URLs (e.g., from postimages.org, imgbb.com)
organization_id: LinkedIn Organization (Company Page) ID
account_id: LinkedIn Ad Account ID - REQUIRED for images to be discoverable via discover_linkedin_assets!
ad_type: Target ad type (single_image_horizontal, single_image_square, single_image_vertical, carousel)

Returns:

Validation results for each image
asset_bundle_id (valid for 60 minutes)
Image URNs for reference

Execution time: 5-15 seconds (downloads, validates, and uploads images)

Workflow:

Call get_linkedin_organizations - get organization_id AND account_id
Call validate_and_prepare_linkedin_assets with BOTH organization_id AND account_id
Use returned asset_bundle_id in create_linkedin_image_campaign

Why account_id matters:

Without account_id, images are uploaded but NOT associated with your ad account
This means discover_linkedin_assets won’t find them later
Always include account_id to make images reusable!

POST

api

tools

validate_and_prepare_linkedin_assets

execute

Validate And Prepare LinkedIn Assets

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/validate_and_prepare_linkedin_assets/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "account_id": "string",
    "ad_type": "single_image_horizontal",
    "image_urls": [
      "string"
    ],
    "organization_id": "string"
  }
}
'

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

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for validating and preparing LinkedIn image assets

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

Add Meta AdUser wants to add another ad/creative variation to an EXISTING ad set. DO NOT USE to create a new campaign. For new campaigns: - Video campaign - `create_meta_video_campaign` - Image campaign - `create_meta_image_campaign` - Carousel campaign - `create_meta_carousel_campaign` Common scenarios: - A/B test ad copy: Different headlines, primary text, or CTAs for the same audience - A/B test creatives: Different images or videos for the same audience - Format testing within one audience: Image vs video ad in the same ad set - Dynamic Creative (DCO): Multiple images + text variations in one ad — Meta auto-optimizes KEY DISTINCTION — add_meta_ad vs add_meta_ad_set: - Same audience, different creative/copy - use THIS tool (add_meta_ad) - Different audience/targeting - use `add_meta_ad_set` instead (creates a new ad set) Ads in the same ad set SHARE: targeting, budget, schedule, pixel tracking. Each ad has its OWN: creative (image/video/carousel), headline, primary text, CTA, landing page. IMPORTANT: You need an ad_set_id from a previously created ad set. Use `list_meta_ad_sets` first if you don't have the ad_set_id. Supports all 3 ad types + Dynamic Creative: - `image`: Different image + copy variation - `video`: Different video + copy variation - `carousel`: Different card set + copy variation - **Dynamic Creative (DCO)**: Pass `image_urls` (2-10 images), `headlines` (up to 5), `primary_texts` (up to 5), `descriptions` (up to 5). Meta tests ALL combinations and optimizes delivery automatically. Dynamic Creative Optimization (DCO) workflow: 1. Create ad set with `is_dynamic_creative=true` via `add_meta_ad_set` 2. Call this tool with `image_urls` (list of 2-10 image URLs), plus optional `headlines`, `primary_texts`, `descriptions` arrays 3. Meta will test all image × headline × text combinations and optimize 4. DCO ad sets support only 1 ad — if the ad set already has is_dynamic_creative enabled, this tool auto-detects it Note: Cannot mix image_urls (DCO) with image_url (single image) or placement-specific images. Standard workflow: 1. Get ad_set_id from prior campaign creation or `list_meta_ad_sets` 2. Write variant ad copy (different headline/primary_text/image) 3. Call this tool with ad_set_id + new creative + copy

Validate And Prepare LinkedIn Assets

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/validate_and_prepare_linkedin_assets/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "account_id": "string",
    "ad_type": "single_image_horizontal",
    "image_urls": [
      "string"
    ],
    "organization_id": "string"
  }
}
'

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