--- title: Meta Marketing API API Integration on Truto slug: metamarketing category: Marketing Automation canonical: "https://truto.one/integrations/detail/metamarketing/" --- # Meta Marketing API API Integration on Truto **Category:** Marketing Automation **Status:** Beta ## Unified APIs ### Unified User Directory API - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ### Unified Ads Management API - **Accounts** — Accounts are the top level resource in the Ads API. Each account has a unique ID and contains a set of campaigns. - **Ad Groups** — Ad Groups are the third level resource in the Ads API. Each ad_group has a unique ID and contains a set of ads. - **Ads** — Ads are the fourth level resource in the Ads API. Each ad has a unique ID and contains a set of creatives. - **Assets** — The assets like images, videos, etc. which can be used in the ads and creatives. - **Campaigns** — Campaigns are the second level resource in the Ads API. Each campaign has a unique ID and contains a set of ad_groups. - **Creatives** — Creatives provide the layout and content for an ad. - **Custom Audiences** — ## How it works 1. **Link your customer's Meta Marketing API account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Meta Marketing API.** The Proxy API is a 1-to-1 mapping of the Meta Marketing API API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Centralize cross-channel ad reporting for marketers** — SaaS analytics platforms can pull Meta campaign performance data — spend, impressions, clicks, and conversions — alongside other ad platforms through Truto's Unified Ads Management API, giving their users a single pane of glass for all paid media metrics. - **Sync CRM segments to Meta Custom Audiences in real time** — CRM and marketing automation platforms can push customer segments directly into Meta as Custom Audiences for retargeting, and dynamically remove converted users to reduce wasted ad spend — all without their end users leaving the SaaS product. - **Automate campaign and creative management at scale** — Ad optimization and e-commerce platforms can programmatically create, pause, or modify Campaigns, Ad Groups, Ads, and Creatives in Meta based on external triggers like inventory changes or performance thresholds, eliminating manual work in Ads Manager. - **Power AI-driven budget and bid optimization** — AdTech SaaS tools can read Ad Group-level budgets and performance data from Meta, apply algorithmic rules or ML models, and write back budget or status changes — enabling autonomous ad management for their users. - **Offer embedded Meta Ads onboarding for non-technical users** — Vertical SaaS platforms serving local businesses or agencies can let their users connect a Meta ad account via Truto's managed auth flow and immediately surface campaign data or launch ads from within the product, abstracting away Meta's API complexity entirely. ## What you can build - **Blended ROAS dashboard across Meta and other ad channels** — Read Accounts, Campaigns, and Ads data from Meta alongside other platforms via the Unified Ads Management API to calculate cross-channel return on ad spend in a single view. - **Automated audience sync from your customer segments** — Push and manage Custom Audiences in Meta directly from CRM or CDP segments, keeping retargeting lists current as users convert or churn. - **Rule-based campaign autopilot** — Poll Ad Group and Campaign performance metrics, then automatically pause underperforming Ads or scale budgets on high-ROAS Ad Groups based on user-defined rules. - **Dynamic creative rotation engine** — Swap Creatives tied to active Ads programmatically when product inventory changes or creative fatigue is detected, keeping ad performance fresh without manual intervention. - **One-click Meta ad account connection** — Use Truto's managed OAuth flow to let end users securely connect their Meta ad accounts in seconds, with token refresh and permission scoping handled automatically. - **Unified campaign structure explorer** — Surface a normalized hierarchy of Accounts → Campaigns → Ad Groups → Ads → Creatives from Meta (and other ad platforms) so users can browse and compare campaign structures without learning each platform's taxonomy. ## FAQs ### How does authentication work for Meta Marketing API through Truto? Meta Marketing API uses OAuth 2.0. Truto manages the entire auth flow — including consent screens, token exchange, and automatic token refresh — so your end users connect their Meta ad accounts with a single click and you never handle raw credentials. ### How does Truto map Meta's ad hierarchy to the Unified Ads Management API? Meta's Ad Accounts, Campaigns, and Ads map directly to the unified Accounts, Campaigns, and Ads objects. Meta's Ad Sets — which control targeting, budgets, and bidding — map to the unified Ad Groups object. Creatives, Assets, and Custom Audiences each have their own unified counterparts. ### Does Truto handle Meta's rate limiting and pagination? Yes. Truto abstracts away Meta's Business Use Case rate limiting and cursor-based pagination. You make standard API calls against Truto's unified endpoints and Truto manages retries, backoff, and page traversal behind the scenes. ### Can I both read and write data to Meta through Truto? The Unified Ads Management API supports both read and write operations across its standardized objects — Accounts, Campaigns, Ad Groups, Ads, Creatives, Assets, and Custom Audiences. This means you can pull performance data and also create or modify campaigns, audiences, and creatives programmatically. ### What if I need Meta-specific fields or endpoints not covered by the unified model? Truto supports proxy requests that let you call Meta's native Graph API endpoints directly through Truto's auth and connection layer, so you can access platform-specific data without losing the benefits of managed authentication and token handling. ### Are there specific Meta Marketing API tools available today, or is this built on request? Meta Marketing API integration is available through Truto's Unified Ads Management API and Unified User Directory API. Individual native tools beyond these unified objects are built on request — if you need a specific endpoint or data type, Truto's team can scope and deliver it quickly.