The API configuration method provides direct integration with Meta's advertising platform, offering real-time ad creation with complete control over creative enhancements and flexible text options.
Overview
The API method:
Connects directly to your Meta account
Allows browsing and selecting existing ads
Creates ads immediately in your account
Provides full control over all ad settings
Supports multiple headlines and descriptions
Step 1: Select Source Ad
Three-Column Navigation
The API selector presents your account structure in three columns:
Campaigns (Left)
Shows all campaigns in your account
Filter by name or status
Active campaigns shown by default
Ad Sets (Middle)
Displays ad sets for selected campaign
Shows budget and status
Filter by name or active status
Ads (Right)
Lists ads in selected ad set
Shows ad names and status
Click to select as template
Finding the Right Ad
Best practices for template selection:
Choose recently created ads (within 30 days)
Select high-performing ads
Ensure ad has desired settings
Verify placement configuration
Using Filters
Each column has filter options:
Search box: Type to filter by name
Active only: Toggle to show/hide paused items
Keyboard navigation: Use arrows and Enter
Step 2: Configure Campaign Structure
Campaign Options
Use Existing Campaign
Adds new ads to the selected campaign
Inherits all campaign settings
Maintains budget and schedule
Create New Campaign
Generates fresh campaign with custom name
Copies objectives and settings
Independent budget control
Ad Set Configuration
Single Ad Set
All ads go into one ad set
Specify custom name
Shares budget across all ads
Ad Set Per Upload
Creates individual ad sets per file
Use {FileName} placeholder for naming
Pattern example: {FileName} - Q4 Campaign
Group Variations
When enabled:
Set variation identifier (e.g., -v or _test)
Files with same base name group together
Creates organized ad set structure
Step 3: Configure Ad Text (Advanced Features)
Multiple Headlines, Primary Texts & Descriptions
Unlike XLSX, the API method supports flexible creative:
Adding Multiple Options
Click the blue plus (+) button to add variants
Enter up to 5 headlines
Add up to 5 primary text options
Include up to 5 link descriptions
Removing Options
Click the red X to remove specific variants
Minimum of 1 required for each field
How Meta Uses Multiple Texts
Meta automatically tests combinations
Optimizes for best-performing variants
Provides more placement flexibility
Individual Text Customization
For unique messaging per ad:
Select "Write unique ad text for each ad"
Customize per upload:
Headlines (5 variants each)
Primary texts (5 variants each)
Link descriptions (5 variants each)
Use Advanced Edit modal for bulk operations
Advanced Edit Modal
Access by clicking the pencil icon:
Features:
Edit all text fields in one view
Set website URLs and display links
Choose call-to-action buttons
Apply changes across all ads
Preview text combinations
Step 4: Creative Enhancements Control
Full Enhancement Management
The API method provides complete control over Meta's automatic optimizations: