Auth type: OAuthDocumentation Index
Fetch the complete documentation index at: https://docs.hyperfx.ai/llms.txt
Use this file to discover all available pages before exploring further.
For connection guidance and permission management, see: App Integrations.
Connect Meta Marketing API
- Go to Settings → Apps in Hyper
- Select Meta Marketing API → Connect New
- Complete OAuth, select Business/Ad Accounts, and grant requested scopes
Common capabilities
- Read campaign and ad performance
- Draft new audiences and creative concepts
Use in Chat
Enable Meta Marketing API and request insights or creative drafts.Use in Agents
Add to toolkits; require approval for write/publish actions.Use in Flows
Automate reporting and creative testing.Troubleshooting
- Missing ad account: ensure Business Manager access and correct selection
- Token expired: reauthorize the connection
Available Actions
Hyper agents can run the following actions for this integration. Each action can be individually set to Enabled, Requires Approval, or Disabled in your agent’s toolkit settings. Actions can be set to one of three control states:| State | Behavior |
|---|---|
| Enabled | Agent runs the action automatically |
| Requires Approval | Agent pauses and waits for your confirmation before proceeding |
| Disabled | Action is blocked and cannot be used |
| Action | Description |
|---|---|
| Ad Insights | Get comprehensive performance insights for any Meta advertising object in a single call |
| Build Placement Spec | Build a placement targeting snippet (publisher_platforms + *_positions) so that |
| Create Ad | Create a new ad in a Facebook ad set with proper creative validation |
| Create Ad Creative | Create a new ad creative for Facebook/Instagram ads |
| Create Ad Legacy | Create a new ad in a Facebook ad set (legacy individual parameters) |
| Create Ad Set | Create a Facebook ad set using a unified interface for both Advantage+ and Manual modes |
| Create Ad Set Legacy | Create a new ad set in a Facebook campaign (legacy individual parameters) |
| Create Advantage Plus Ad Set | Create an Advantage+ ad set with AI-powered audience expansion |
| Create Campaign | Create a new campaign in a Facebook Ad Account |
| Create From Blueprint | Create a full campaign (campaign + ad sets + ads) from a validated blueprint |
| Create Manual Ad Set | Create a manual ad set with custom targeting and placements |
| Delete Ad | Delete a Facebook ad |
| Delete Ad Creative | Delete a Facebook ad creative |
| Delete Ad Image | Delete single or multiple uploaded images from a Facebook ad account |
| Delete Ad Set | Delete a Facebook ad set |
| Delete Ad Video | Delete single or multiple uploaded videos from a Facebook ad account |
| Delete Campaign | Delete a Facebook campaign |
| Get Account Info | Get detailed information for a single Facebook ad account |
| Get Ad Creative | Get details of a specific Facebook ad creative |
| Get Ad Details | Get detailed fields for a single ad by ad ID |
| Get Ad Image | Get a single ad image by image hash from an ad account |
| Get Ad Pixel | Get a single Meta (Facebook) Pixel by pixel ID |
| Get Ad Previews | Generate previews for Facebook ad creatives across multiple ad formats in a single call |
| Get Ad Sets | Get ad sets for a specific Facebook campaign |
| Get Ads | Get ads for a specific Facebook ad set |
| Get Adset Details | Get detailed fields for a single ad set by ad set ID |
| Get Campaign Details | Get detailed fields for a single campaign by campaign ID |
| Get Health Check | |
| Get Insights | Get performance metrics for a Facebook ad object (account, campaign, ad set, or ad) |
| Get Meta Accounts | Get all Facebook Pages (Meta accounts) accessible with the current access token with response filtering support |
| List Ad Accounts | List all Facebook Ad Accounts and associated Pages accessible with the current access token |
| List Ad Creatives | List ad creatives for a Facebook ad account with pagination support |
| List Ad Images | List uploaded images for a Facebook ad account with response filtering support |
| List Ad Pixels | List Meta (Facebook) Pixels for a given Ad Account |
| List Ad Videos | List uploaded videos for a Facebook ad account with response filtering support |
| List Custom Audiences | List custom audiences on an ad account (subtype CUSTOM/WEBSITE/APP/etc.) |
| List Dataset Conversions | List conversion events configured on an offline dataset |
| List Instagram Accounts | List Instagram accounts connected to a Facebook ad account |
| List Lead Forms | List lead generation forms for a Facebook Page |
| List Lookalike Audiences | List lookalike audiences (subtype LOOKALIKE) for an ad account |
| List Owned Pages | List Facebook pages owned by the business associated with an ad account with response filtering support |
| List Tracking Assets | List Meta pixels and offline datasets available on an ad account |
| Preview Blueprint | Preview and validate a full campaign blueprint BEFORE creating anything on Meta |
| Replace Ad Media | Replace the media on an existing ad by creating a compliant replacement creative |
| Run Health Check | Run a health check on all Meta ad accounts, verifying ad account access, page publishing, Instagram linking, pixel data, and catalog capabilities |
| Search Campaigns | Search for campaigns in a Facebook Ad Account with response filtering support |
| Search Pages | Search for Facebook Pages by name or keywords |
| Targeting Search | Unified Targeting Search for Meta Marketing API (/search) |
| Update Ad | Update an existing Facebook ad |
| Update Ad Creative | Update an existing Facebook ad creative |
| Update Ad Set | Update an existing Facebook ad set |
| Update Campaign | Update an existing Facebook campaign with new settings |
| Upload Ad Image | Upload single or multiple images for use in Facebook ad creatives from file IDs or URLs |
| Upload Ad Video | Upload single or multiple videos for use in Facebook ad creatives from file IDs or URLs |
| Upload Conversion Events | Upload conversion events to Meta Conversions API for server-side event tracking |
| Upload Offline Events | Upload offline conversion events to Meta Conversions API |