API Configuration Method

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:

1. Campaigns (Left)

   • Shows all campaigns in your account
   • Filter by name or status
   • Active campaigns shown by default

2. Ad Sets (Middle)

   • Displays ad sets for selected campaign
   • Shows budget and status
   • Filter by name or active status

3. 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:

1. Set variation identifier (e.g., -v or _test)
2. Files with same base name group together
3. Creates organized ad set structure

Step 3: Configure Ad Text

Text Mode Options

Apply Common Text to All Ads

Same text shared across all ads. Fastest setup.

Write Unique Ad Text Per Ad Set

Different text for each ad set group. Opens editing modal with table view.

Write Unique Ad Text for Each Ad

Complete control over individual ads. Opens editing modal with media thumbnails for visual reference.

Flexible vs. Separate Text Strategy

Flexible Texts (Recommended):

• Meta automatically tests combinations of your headlines, texts, and descriptions
• Performance tracked at ad level

Separate Ads:

• Creates individual ad for each text combination
• Detailed reporting per text variant

Toggle between strategies using the switch above your text inputs.

Multiple Headlines, Primary Texts & Descriptions

Adding Multiple Options

1. Click the blue plus (+) button to add variants
2. Enter up to 5 headlines
3. Add up to 5 primary text options
4. Include up to 5 link descriptions

Removing Options

• Click the red X to remove specific variants
• Minimum of 1 required for each field

Individual Text Customization

For unique messaging per ad or per ad set:

1. Select "Write unique ad text per ad set" or "Write unique ad text for each ad"
2. Click the edit button to open modal
3. Edit inline with auto-expanding text fields
4. Use Apply to All for bulk changes

Per-ad mode shows media thumbnails for visual reference.

Step 4: Ad Scheduling (Optional)

Schedule ads to start at a specific date and time.

Available only when creating new ad sets.

1. Check "Schedule these ads to start at a specific time"
2. Select date and time (uses ad account's timezone)
3. Minimum 15 minutes in the future

Ads are created paused and activate automatically at the scheduled time.

Step 5: Creative Enhancements Control

The API method provides control over Meta's automatic optimizations. Checkboxes reflect current ad settings and can be toggled on/off as needed.

Step 6: Publication Options

Create Ads in Paused Status

Check "Create ads in paused status" to create ads paused instead of active.

When Unchecked (Default):

• Ads enter Meta's review immediately
• Start delivering once approved

When Checked:

• Ads created paused
• Activate manually in Meta Ads Manager when ready
• Useful for campaign preparation or team review

Note: Only ads are paused. Campaigns and ad sets are always created active.

Step 7: Create Ads

Initiation

1. Click "Create Ads" button
2. Confirm settings in popup
3. Monitor progress in the progress bar