This article outlines how Zitcha interacts with advertising platforms across two core workflows, Zitcha 1.0 (Orders) and Zitcha 2.0 (Planning). It documents the key campaign, ad set, ad, product, and reporting endpoints that underpin how campaigns are created, managed, and measured across versions of the platform.
The goal is to provide a clear, practical reference for how planning and execution differ between workflows, and how Zitcha maintains consistency across them.
| Action | Graph API Endpoint | HTTP |
|---|
| Create campaign | /{ad_account_id}/campaigns | POST |
| Update campaign | /{campaign_id} | PATCH |
| Pause campaign | /{campaign_id} | PATCH |
| Activate campaign | /{campaign_id} | PATCH |
| Delete campaign | /{campaign_id} | DELETE |
| Find campaigns | /{ad_account_id}/campaigns | GET |
| Action | Graph API Endpoint | HTTP |
|---|
| Create ad set | /{ad_account_id}/adsets | POST |
| Update ad set | /{adset_id} | PATCH |
| Stop ad set (set end_time) | /{adset_id} | PATCH |
| Delete ad set | /{adset_id} | DELETE |
| Find ad sets | /{ad_account_id}/adsets | GET |
| Action | Graph API Endpoint | HTTP |
|---|
| Create ad | /{ad_account_id}/ads | POST |
| Update ad | /{ad_id} | PATCH |
| Delete ad | /{ad_id} | DELETE |
| Find ads | /{ad_account_id}/ads | GET |
| Action | Graph API Endpoint | HTTP |
|---|
| Create product set | /{catalog_id}/product_sets | POST |
| Find product sets by products | /{catalog_id}/product_sets | GET |
| Action | Graph API Endpoint | HTTP |
|---|
| Generate ad preview | /{ad_account_id}/generatepreviews | GET |
| Action | Graph API Endpoint | HTTP |
|---|
| Get account insights | /{ad_account_id}/insights | GET |
account_id, campaign_id, campaign_name, adset_id, adset_name, ad_id, ad_name, product_id, frequency, date_start, date_stop, action_values, actions, spend, impressions, clicks, reach, cost_per_action_type, cpc, cpm, ctr, website_ctr, website_purchase_roas, purchase_roas, conversion_values, conversions, result_values_performance_indicator, landing_page_view_per_link_click, cost_per_result, cost_per_ad_click, cost_per_conversion, results
| Action | Graph API Endpoint | HTTP | Ad Format |
|---|
| Check MPA eligibility | /{business_id} | GET | MPA Only |
| List pages shared with business | /{business_id}/client_pages | GET | MPA Only |
| Action | Graph API Endpoint | HTTP |
|---|
| List client ad accounts | /{business_id}/client_ad_accounts | GET |
| List owned ad accounts | /{business_id}/owned_ad_accounts | GET |
| List campaigns for account | /{ad_account_id}/campaigns | GET |
| List ad sets for account | /{ad_account_id}/adsets | GET |
| List ads for account | /{ad_account_id}/ads | GET |
| Action | Graph API Endpoint | HTTP |
|---|
| Create campaign | /{ad_account_id}/campaigns | POST |
| Create ad set | /{ad_account_id}/adsets | POST |
| Create ad | /{ad_account_id}/ads | POST |
| Action | Graph API Endpoint | HTTP |
|---|
| Get campaign insights | /{campaign_id}/insights | GET |
| Get account insights for time range | /{ad_account_id}/insights | GET |
clicks, cpc, cpm, impressions, reach, spend, action_values, actions, purchase_roas, cost_per_inline_link_click, inline_link_clicks, converted_product_quantity, converted_product_value, catalog_segment_value, catalog_segment_actions, frequency, campaign_id
| Action | Graph API Endpoint | HTTP | Ad Format |
|---|
| List owned product catalogs | /{business_id}/owned_product_catalogs | GET | |
| List client product catalogs | /{business_id}/client_product_catalogs | GET | |
| Get products in catalog | /{catalog_id}/products | GET | |
| Get product details | /{product_id} | GET | |
| Get product set details | /{product_set_id} | GET | |
| List product sets in catalog | /{catalog_id}/product_sets | GET | |
| Create product set | /{catalog_id}/product_sets | POST | MPA & DPA only |
| Update product set name/filter | /{product_set_id} | POST | MPA & DPA only |
| Get products in product set | /{product_set_id}/products | GET | |
| Action | Graph API Endpoint | HTTP | Ad Format |
|---|
| Get targeting description | /{ad_account_id}/targeting_sentence_lines | GET | |
| Get reach estimate | /{ad_account_id}/reachestimate | GET | |
| Batch get reach estimates | Batch POST with act_{id}/reachestimate | POST | |
| Get custom & lookalike audiences | /{ad_account_id}/customaudiences | GET | |
| List saved audiences | /{ad_account_id}/saved_audiences | GET | |
| Get single saved audience | /{audience_id} | GET | |
| Search targeting options | Via TargetingSearch SDK | GET | |
| Check custom audience TOS acceptance | /{ad_account_id} | GET | MPA only |
| Accept custom audience TOS | /{ad_account_id}/custom_audiences_tos | POST | MPA only |
| Accept value-based custom audience TOS | /{ad_account_id}/custom_audiences_tos | POST | MPA only |
| Accept web custom audience TOS | /{ad_account_id}/custom_audiences_tos | POST | MPA only |
| Share custom audience with ad account | /{audience_id}/adaccounts | POST | MPA only |
| Action | Graph API Endpoint | HTTP | Ad Format |
|---|
| List shared pages | /{user_id}/accounts | GET | |
| List pages accessible to business | /{business_id}/client_pages | GET | MPA only |
| Get page access token | /{page_id} | GET | MPA only |
| Share page with business | /{page_id}/agencies | POST | MPA only |
| Revoke page access | /{page_id}/agencies | DELETE | MPA only |
| Action | Graph API Endpoint | HTTP |
|---|
| Upload image | /{ad_account_id}/adimages | POST |
| Upload video | /{ad_account_id}/advideos | POST |
| Get ad preview | /{ad_id}/previews | GET |
| Generate preview from creative | /{ad_account_id}/generatepreviews | GET |
