Validate And Prepare Meta Assets

User wants to upload NEW images for Meta campaigns. This tool validates images and uploads them to Meta to get image hashes.

This tool validates image URLs against Meta’s specifications and uploads them to get image hashes needed for campaign creation. It stores validated assets in a temporary bundle (60-minute TTL).

Returns:

Validation results (pass/fail per image)
Image hashes for successfully uploaded images
Asset bundle ID for use in campaign creation
Placement compatibility information

When to use this tool:

“Upload this image for my Meta campaign”
“Validate my product images for Facebook ads”
“Prepare images for Instagram ads”
User provides image URLs and wants to create a campaign

Parameters:

image_urls: List of public URLs to validate and upload (1-10 images)
placement: Target placement - ‘feed’ (default), ‘stories_reels’, or ‘carousel’
ad_account_id: Required for multi-account users. Get from list_connected_accounts

Execution time: 5-15 seconds (depends on image count and size) Data source: Meta Ad Image Upload API

Image Requirements:

Placement	Aspect Ratio	Min Dimensions	Max Size
Feed	1:1 or 4:5	600x600	30MB
Stories/Reels	9:16	500x888	30MB
Carousel	1:1	1080x1080	30MB

Workflow:

Use validate_and_prepare_meta_assets with image URLs
If successful, receive an asset_bundle_id
Use that bundle_id with create_meta_image_campaign

POST

api

tools

validate_and_prepare_meta_assets

execute

Validate And Prepare Meta Assets

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

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for validate_and_prepare_meta_assets)"
  },
  "success": true,
  "tool": "validate_and_prepare_meta_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 uploading Meta ad images

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 TikTok AdAdd a new ad to an existing TikTok ad group. Use this when you need to add additional ads (creatives) to an ad group that was already created. Supports all ad formats: - SINGLE_IMAGE: Provide image_urls (public HTTPS URLs — auto-uploaded) OR image_ids (pre-uploaded TikTok IDs) - SINGLE_VIDEO: Provide video_id (TikTok video ID from creative library) - Spark Ads: Boost organic TikTok posts (requires tiktok_item_id + identity_type=TT_USER) - Carousel: Multi-card ads (first call create_tiktok_carousel_card to get card_id, then provide card_id + card_type here) Identity (identity_id) is auto-resolved — you do NOT need to provide it unless using Spark Ads. Images are auto-uploaded from URLs — you do NOT need to call upload_tiktok_images first. This is useful for: - Testing different creatives in the same ad group - Adding new ad variations without creating a new campaign - A/B testing ad copy, images, or CTAs Required: adgroup_id, ad_text, landing_page_url. For image ads: provide image_urls (easiest) or image_ids. For video ads: provide video_id. For Spark Ads: provide tiktok_item_id and set identity_type to TT_USER.

Validate And Prepare Meta Assets

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

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