Ads and Commerce

Ads and Commerce

Marketing API Overview

About Marketing API

Data Processing Options

Get Started with Marketing API

Ad Creation Guides

Basic Ad Creation

Create an Ad Campaign

Create an Ad Set

Create an Ad Creative

Manage Campaigns

Ad Performance & Optimization

Optimization Basics

Monitoring and Analytics

Optimization Tips

Introduction to Ad Creatives

Video & Carousel Ads

Video & Carousel

Instant Experiences

Lead Ads Guides

Quality Features

Testing and Troubleshooting

Advantage+ Catalog Ads for Leadgen

CRM Integration

Instagram Ads Guides

Threads Ads Guides

Threads Ads Creation

Advantage+ Catalog Ads

Reply Moderation

Threads Ads Insights

Messaging Ads Guides

Click to Messenger

Click to Instagram

Click to WhatsApp

Multidestination

Partnership Ads

Event and Local Ads

Advantage+ Campaigns

Advantage+ Shopping Campaign Guides

Advantage+ Shopping Campaign API

Cross-Channel Conversion Optimization

Audience Type URL Parameters

Asset Feed Spec Guides

Asset Feed Spec

Asset Feed Options

Dynamic Creative

Customization Rules

Asset Customization Rules

Placement Asset Customization

Multi-Language Ads

Advantage+ Catalog Ads Guides

Advantage+ Catalog Ads

Advantage+ Catalog Ads Mobile

Advantage+ App Campaigns

Dynamic Media Guides

Multi-Aspect Ratio Images

Advantage+ Creative for Catalog

Real Estate Ads Guides

Real Estate Ads

Audiences & Management

Travel Ads Guides

Travel Ads - Audience Management

Hotel Ads Guides

Hotel Ads - Catalog & Feed

Hotel Ads - Events

Hotel Ads - Template Tags

Hotel Ads - Date-Specific Prices

Flight Ads Guides

Flight Ads Catalog & Feed

Flight Ads - Template Tags

Destination Ads Guides

Destination Ads

Destination Catalog

Destination Events

Destination Ads - Template Tags

Automotive Ads Guides

Automotive Ads Management

Automotive Inventory Ads

Automotive Model Ads

Audience Management

Advantage+ Catalog Ads with an On-Facebook Destination

Advantage+ Creative Guides

Advantage+ Creative

Product Extensions for Advantage+ Creative

Standard Enhancements for Advantage+ Creative

Advantage+ Creative Preview API

Omnichannel Ads

Generative AI Features

Collaborative Ads Guides

Product Set Optimization

Multi-advertiser Ads

Call Ads Guides

Callback Feeature

Flexible Ad Format

Format Automation

Budget & Strategy

Pacing and Scheduling

Bidding & Optimization

Advantage Campaign Budget

Ad Set Budget Sharing

Optimized Cost Per Mille Ads

Cost Per Action Ads

Bid Multipliers

Cross-Channel Conversion Optimization

Ad Rules Engine Guides

Ad Rules Engine

Evaluation Spec

Trigger Based Rules

Schedule Based Rules

Advanced Scheduling

Evaluation Spec Filters

Rebalance Budget

Audience Guides

Limits & Best Practices

Tracking and Conversion Specs

Marketing Mix Modeling

Conversion Lift Measurement

Brand Safety and Suitability Guides

Brand Safety and Suitability

Integration Setup

Publisher Block Lists API

Content Allow Lists API

Content Block Lists API

Content Delivery Reports API

Feed Verification API

Publisher Delivery Reports API

Partner-publisher Lists API

Best Practices & Recommendations

Ads Performance Recommendations

Omni Optimal Setup Guide

Manage Your Ad Object's Status

Async and Batch Requests

Post-Processing for Ad Creation

Troubleshooting

Standard Error Codes

iOS 14 Error Codes

Version Changelogs

Out-of-Cycle Change Index

Out-of-Cycle Changes

Conversions API

Conversions API Overview

Verifying Setup

Main Body Parameters

Server Event Parameters

Customer Information Parameters

Customer Information Parameters

fbp and fbc Parameters

Standard Parameters

App Data Parameters

Original Event Data

Parameter Builder Library

Parameter Builder Library

Workflow and Examples

Conversions API for App Events

Conversions API for Offline Events

Conversions API for Business Messaging

Conversion Leads Integration

Conversion Leads Integration

1: Connecting Your CRM to Download Leads

2: Getting Started with Integration

3: Developer Implementation

3: Zapier Implementation

3: Zapier Implementation

Step 1: Implement Integration

Step 2: Verify Integration

4: Verify Your Data

5: Configure Your Sales Funnel

6: Follow-up Steps

Payload Specification

Find the Lead ID

Dataset Quality API

Dataset Quality API

Dataset Quality API for Offline Events

Handling Duplicate Events

End-to-end Implementation

Conversions API as a Platform

Zapier Integration

Conversions API for Google Tag Manager

Conversions API for CRM for Platforms

Set Up Conversions API with Salesforce Webhooks

Business SDK Features for Conversions API

Integration Guidance: Value Optimization

Conversions API Gateway

Conversions API Gateway

Getting Started

DNS Setup Guide

Post-Setup Management

Non-Web Server Events API Support

System Health Information

Enhance Events with Advanced Matching Data

Include Facebook Login Data in the Conversions API

Troubleshooting Tools

Troubleshooting Guide

Uninstall Guide

Conversions API Gateway: AWS App Runner

Conversions API Gateway: AWS App Runner

Cost Monitoring

Custom Domain Setup

Scaling Control

Automatic and Manual Updates

Uninstall Guide

Conversions API Gateway for Multiple Accounts

Conversions API Gateway for Multiple Accounts

Host Onboarding: AWS EKS

Host Onboarding: AWS EKS

1. Create Instance

2. Configure a Host Account

3. Set Up Custom Domain

Host Onboarding: AWS App Runner

Host Onboarding: AWS App Runner

1. Create Instance

2. Configure a Host Account

3. Set Up Custom Domain

Host Onboarding: GCP

Host Onboarding: GCP

1. Create Instance

2. Create a Custom Domain

3. Set Auto-Scaling Limits

Host Management

Host Management

Host User Management

Managing Hosted Accounts

Set Up SMTP Configuration

Account Onboarding and Management

Account Onboarding and Management

Onboarding and Offboarding Unmanaged Accounts

User Management for Hosted Accounts

Data Source Management

Manage Domain Allow and Block Lists

Configure Data Routing for Hosted Accounts

AWS EKS Architecture

AWS App Runner Architecture

GCP Architecture

Monitoring Your Setup

Prospective Agencies: FAQs

Troubleshooting Tools

Troubleshooting Guide

Uninstall Guide

Conversions API Gateway for Multiple Accounts Control Plane API

Conversions API Gateway for Multiple Accounts Control Plane API

Account Management

User Management

Pixel Management

Account Data Routing Configuration

Account Event Metrics

Troubleshooting

Conversions API Gateway and Signals Gateway

Gateway Products Overview

Conversions API Gateway

Conversions API Gateway

Instance Activation

Enhance Events With Additional User Data

Include Facebook Login Data in the Conversions API

Monitor Your Setup

Data Source Management

Uninstall Guide

Signals Gateway

Host Management

Host Management

Post-Setup Management

Account Management

Account Management

Onboarding and Offboarding Unmanaged Hosted Accounts

Manage Domain Allow-Lists and Block-Lists

Host User Management

Set Up SMTP Configuration

Set Auto-Scaling Limits

System Health Information

DNS Setup Guide

Conversions API Gateway Pipeline

Conversions API Gateway Pipeline

Advanced Matching

Include Facebook Login Data

Control Plane API

Control Plane API

Account Management

User Management

Pixel Management

Account Data Routing

Account Event Metrics

Set Up Data Pipelines

Set Up Data Pipelines

Data Destinations

GCP GKE Onboarding

GCP GKE Onboarding

Create an Instance: Agencies and Partners

Create Instance From Events Manager

GCP Architecture

Create Custom Domain for GCP

AWS EKS Onboarding

AWS EKS Onboarding

Create an Instance: Agencies and Partners

AWS Architecture

Set Up Custom Domain

AWS ECS Express Onboarding

AWS ECS Express Onboarding

AWS ECS Express Architecture

Custom Domain Setup

Cost Monitoring

Troubleshooting Guide

Sending Events From a Server

Uninstall Guide

Supported Products and Services

Catalog Integration Using Meta Business SDK

Media Titles Catalog Edge

Media Titles Product Set Edge

Media Titles Feed Edge

Apps and Software

Apps and Software

Apps and Software Catalog Edge

Apps and Software Product Set Edge

Apps and Software Feed Edge

Commerce Platform

User Experience

Payment and Data Flows

Accounts and Assets

API Integration Setup

Seller Integration

Partner Integration

Partner Integration Basics

Onboarding Integration

Catalog Integration

Build Offers Integration

Order Integration

Platform Integration

Onboarding Integration for FBE

Commerce Manager Redirect Onboarding

Page Eligibility for Commerce

Troubleshooting

Merchant Distribution for MP/IG

Merchant Distribution for MP/IG

Marketplace Approval API

Merchant Support

Validate the Integration

Product Review Feed Schema

Feed Schema CSV

Automate Ratings and Reviews Seller Analysis

Migrate to Simplified Shops Ads API

Set Up Checkout URL

Enable Subscriptions

Shops Ads Lightweight BOPIS Experience

Shops Ads Heavyweight BOPIS Experience

Catalog and Inventory

Order Management

Order Lifecycle

Acknowledgement API

Order Snapshot API

Fulfillment API

Cancellation and Refund API

Legacy API Reference

Shipping Profiles API Reference

Associate Shipping Profiles with Products

Shipping Carrier Codes

Finance Reporting

Finance and Tax

Plan Your Integration

Commerce Integration - Platform Partners

Shipping and Fulfillment

Customer Communication

Resources

Adrules Governed

Facebook Feedback

Targetingsentencelines

Aaa Compatible Ad Objects

Account Controls

Ad Column Sizes

Ad Custom Derived Metrics

Ad Place Page Sets

Ad Place Page Sets Async

Adrules Count By Type

Adrules Library

Ads Reporting Mmm Reports

Ads Reporting Mmm Schedulers

Applied Publisher Block Lists

Async Batch Requests

Asyncadcreatives

Asyncadrequestsets

Broadtargetingcategories

Campaign Attribution Options

Collaborative Ads Partner Businesses

Connected Instagram Accounts

Customaudiences

Customaudiencestos

Customconversions

Delivery Estimate

Deprecatedtargetingadsets

Dsa Recommendations

Generatepreviews

Impacting Ad Studies

Instagram Accounts

Locationclusters

Mcmeconversions

Message Delivery Estimate

Minimum Budgets

Naming Templates

Offline Conversion Data Sets

Optimization Goals Aemv2 Eligibility

Product Audiences

Publisher Block Lists

Reachfrequencypredictions

Saved Audiences

Smart Suggested Ads

Start Your Day Widgets

Subscribed Apps

Targetingbrowse

Targetingsearch

Targetingsuggestions

Targetingvalidation

Urls For Asset Extraction

Website Creative Assets

Website Creative Info

Youth Ads Advertiser

Ad Account User

Creative Insights

Adrules Governed

Budget Schedules

Ad Preview Plugin

Ad Promoted Object

Adrules Governed

Asyncadrequests

Budget Schedules

Budget Split Set

Campaign Actions

Delivery Estimate

Message Delivery Estimate

Publisher Delivery Report

Targeting Insights

Targetingsentencelines

Continuous Lift Config

Related Ad Accounts

Add Phone Numbers

Adnetworkanalytics

Adnetworkanalytics Export

Adnetworkanalytics Results

Ads Custom Pivots Preview

Ads Reporting Exports

Ads Reporting Mmm Reports

Ads Reporting Mmm Schedulers

An Publisher Blocklist Apps

An Publisher Blocklist Categories

An Publisher Blocklist Domains

An Publisher Blocklist Pages

Applied Publisher Block Lists

Business Asset Groups

Business Invoices

China Business Onboarding Attributions

Claim Custom Conversions

Client Ad Accounts

Client Business Asset Groups

Client Instagram Accounts

Client Instagram Assets

Client Offsite Signal Container Business Objects

Client Product Catalogs

Client Publisher Block Lists

Client Whatsapp Business Accounts

Collaborative Ads Collaboration Requests

Collaborative Ads Suggested Partners

Commerce Merchant Settings

Content Block Lists

Creative Asset Tags

Creative Folders

Customconversions

Event Source Groups

Extendedcredits

Finance Permissions

Ig Bc Ad Permissions

Initiated Audience Sharing Requests

Initiated Sharing Agreements

Instagram Accounts

Instagram Business Accounts

Managed Businesses

Managed Partner Ads Funding Source Details

Managed Partner Businesses

Measurement Reports

Offline Conversion Data Sets

Openbridge Configurations

Owned Ad Accounts

Owned Businesses

Owned Custom Conversions

Owned Instagram Accounts

Owned Instagram Assets

Owned Offsite Signal Container Business Objects

Owned Product Catalogs

Owned Publisher Block Lists

Owned Whatsapp Business Accounts

Parent Advertiser Infos

Partner Account Linking

Partner Center Export Files

Partner Relationships

Pending Client Ad Accounts

Pending Client Apps

Pending Client Pages

Pending Offline Conversion Data Sets

Pending Owned Ad Accounts

Pending Owned Pages

Pending Shared Offsite Signal Container Business Objects

Pending Shared Pixels

Preverified Numbers

Publisher Block Lists

Received Audience Permissions

Received Audience Sharing Requests

Received Inprogress Onbehalf Requests

Received Inprogress Transfer Ownership Agreements

Received Sharing Agreements

Reseller Events

Reseller Guidances

Resellervettingrequests

Salesrights Inventory Management

Self Certified Whatsapp Business Submissions

Self Certify Whatsapp Business

Sent Inprogress Onbehalf Requests

Share Preverified Numbers

Shared Audience Permissions

Sso Migrated Business Users

Sso Unmigrated Business Users

System User Access Tokens

Third Party Partner Lift Requests

Third Party Partner Panel Recurring Requests

Third Party Partner Panel Requests

Third Party Partner Viewability Requests

Whatsapp Business Accounts

Business Role Request

Assigned Client Assets

Assigned Owned Assets

Assigned Ad Accounts

Assigned Ads Pixels

Assigned Business Asset Groups

Assigned Creative Folders

Assigned Instagram Accounts

Assigned Monetization Properties

Assigned Offline Conversion Data Sets

Assigned Product Catalogs

Assigned Whatsapp Business Accounts

Custom Audience Targeting

Shared Account Campaign Info

Shared Account Info

High Demand Period

Product Catalog

Assigned Ad Accounts

Assigned Ads Pixels

Assigned Business Asset Groups

Assigned Creative Folders

Assigned Instagram Accounts

Assigned Monetization Properties

Assigned Offline Conversion Data Sets

Assigned Product Catalogs

Assigned Whatsapp Business Accounts

Partnership Ads API

Updated: Mar 26, 2026

Partnership ads allow you to run Facebook and Instagram ads from a creator or other partner’s handle to scale collaborations. Using a creator’s voice with partnership ads is the most performant way to run creator content on Meta’s platforms.

These guides discuss how to use the Partnership Ads API to automate partnership ad campaign features and permissions.

To get started, see the following topics:

Post-Level Permissioning

Account-Level Permissioning

Partnership Ads Creation

Did you find this page helpful?