> ## Documentation Index > Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Meta Ads > Set up and use the Meta Ads integration with Hyper AI Auth type: OAuth For connection guidance and permission management, see: [App Integrations](/integrations/overview). ## Connect Meta Marketing API 1. Go to Settings → Apps in Hyper 2. Select Meta Marketing API → Connect New 3. 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 | Configure these in the agent's toolkit settings or in workspace defaults. | 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 |