Appearance
Ad Account Ad Creatives
Updated: May 3, 2026
Reading
The Ad Creatives that belong to this Ad Account.
Contains creative content for an ad account that you can use in your ads. Includes images, videos and so on. Using an ad account creative for a particular ad is subject to validation rules based on the ad type and other rules. See Facebook Ads Guide and Validation, Objectives and Creative.
Example
Select language
HTTPPHP SDKJavaScript SDKAndroid SDKiOS SDKcURL
GET /v25.0/act_<AD_ACCOUNT_ID>/adcreatives?fields=name HTTP/1.1
Host: graph.facebook.comTry it in Graph API Explorer
If you want to learn how to use the Graph API, read our Using Graph API guide
Parameters
This endpoint doesn't have any parameters.
Fields
Reading from this edge will return a JSON formatted result:
{
"data": [],
"paging": {},
"summary": {}
}data
A list of AdCreative nodes.
paging
For more details about pagination, see the Graph API guide.
summary
Aggregated information about the edge, such as counts. Specify the fields to fetch in the summary param (like summary=total_count).
| Field | Description |
|---|---|
total_count unsigned int32 | Total number of creatives in the ad account. |
Error Codes
| Error Code | Description |
|---|---|
| 200 | Permissions error |
| 100 | Invalid parameter |
| 80004 | There have been too many calls to this ad-account. Wait a bit and try again. For more info, please refer to /docs/graph-api/overview/rate-limiting#ads-management. |
| 190 | Invalid OAuth 2.0 Access Token |
| 2500 | Error parsing graph query |
Creating
/act_{ad_account_id}/adcreatives
You can make a POST request to adcreatives edge from the following paths:
When posting to this edge, no Graph object will be created.
Limitations
- When creating ad creatives, if the
object_story_idbeing used is already in use by an existing creative, then the API will return the value of the existing creative_id instead of creating a new one. - Using
radiuscan cause an error, code: 100, subcode 1815946, when targeting multiple locations. We recommend creating an ad for each location or not usingradiusin your call.
Example
Select language
HTTPPHP SDKJavaScript SDKAndroid SDKiOS SDKcURL
POST /v25.0/act_<AD_ACCOUNT_ID>/adcreatives HTTP/1.1
Host: graph.facebook.com
name=Sample+Promoted+Post&object_story_id=%3CPAGE_ID%3E_%3CPOST_ID%3ETry it in Graph API Explorer
If you want to learn how to use the Graph API, read our Using Graph API guide
Parameters
| Parameter | Description |
|---|---|
actor_id int64 | The actor ID (Page ID) of this creative. |
ad_disclaimer_spec JSON object | Disclaimer information to attach to your creative. --- title enum {DISCLAIMER, HEALTH_DISCLAIMER, IMPORTANT_SAFETY_INFORMATION, MEDICATION_GUIDE, OFFER_DETAILS, PRESCRIBING_INFORMATION, TERMS_AND_CONDITIONS} required text string url URL Show child parameters |
adlabels list<Object> | Ad Labels associated with this creative. Used to group it with related ad objects. |
applink_treatment enum{automatic, deeplink_with_web_fallback, deeplink_with_appstore_fallback, web_only} | Used for Dynamic Ads. Specify what action should occur if a person clicks a link in the ad, but the business' app is not installed on their device. For example, open a webpage displaying the product, or open the app in an app store on the person's mobile device. |
asset_feed_spec Object | Used for Dynamic Creative to automatically experiment and deliver different variations of an ad's creative. Specifies an asset feed with multiple images, text and other assets used to generate variations of an ad. Formatted as a JSON string. supports emoji --- images list<Object> --- hash string url URL image_crops dictionary { enum{191x100, 100x72, 400x150, 600x360, 100x100, 400x500, 90x160, 300x400} : <list<list<int64>>> } url_tags string adlabels list<Object> tag string Show child parameters videos list<Object> --- video_id int64 thumbnail_id int64 thumbnail_url URL thumbnail_hash string caption_ids list<numeric string> url_tags string adlabels list<Object> do_not_clone_flag boolean tag string thumbnail_source string Show child parameters bodies list<Object> --- text string supports emoji url_tags string adlabels list<Object> translation_confidence int64 asset_source enum {ACO_TEXT_LIBRARY, TEXT_GEN_INPUT_TEXT, TEXT_GEN_SUGGESTION_DIVERSITY_UNEDITED, TEXT_GEN_SUGGESTION_DIVERSITY_EDITED, TEXT_GEN_SUGGESTION_DIVERSITY_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_DIVERSITY_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_PARAPHRASING_UNEDITED, TEXT_GEN_SUGGESTION_PARAPHRASING_EDITED, TEXT_GEN_SUGGESTION_PARAPHRASING_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_PARAPHRASING_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNEDITED, TEXT_GEN_SUGGESTION_LLM_EDITED, TEXT_GEN_SUGGESTION_LLM_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_UNEDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_EDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_EDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_UNEDITED, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_EDITED, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_ORCHESTRATOR_MULTILINGUAL_UNEDITED, TEXT_GEN_SUGGESTION_ORCHESTRATOR_MULTILINGUAL_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_LLM_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_LLM_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_1_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_2_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_2_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_SINGLE_STAGE_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_V_1_1_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_ORCHESTRATOR_V_1_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_ORCHESTRATOR_V_1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_LONG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_LONG_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_LONG_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_LONG_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V3_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V3_EDITED, TEXT_GEN_SUGGESTION_LLM_V3_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V3_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V3_LONG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V3_LONG_EDITED, TEXT_GEN_SUGGESTION_LLM_V3_LONG_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V3_LONG_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_FOR_IG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_FOR_IG_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_UNEDITED, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_EDITED, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V3_UNEDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V3_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_FOR_FB_UNEDITED, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_FOR_FB_EDITED, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_HEURISTICS_V1_UNEDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_HEURISTICS_V1_EDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_LLAMA4_HOOKS_UNEDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_LLAMA4_HOOKS_EDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_GPT_OSS_HOOKS_UNEDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_GPT_OSS_HOOKS_EDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_OSS_BUNDLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_OSS_BUNDLE_EDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_L4BASE_BUNDLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_L4BASE_BUNDLE_EDITED, TEXT_GEN_SUGGESTION_PPO_ORCHESTRATOR_V1_UNEDITED, TEXT_GEN_SUGGESTION_PPO_ORCHESTRATOR_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_ALIGNER_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_ALIGNER_EDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_PRIMARY_TEXT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_PRIMARY_TEXT_EDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_HISTORICAL_ADS_UNEDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_HISTORICAL_ADS_EDITED, TEXT_GEN_SUGGESTION_LLM_FREEFORM_BRAND_TONE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_FREEFORM_BRAND_TONE_EDITED, TEXT_GEN_SUGGESTION_LLM_COHORT_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_COHORT_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_LIGHTHOUSE_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LIGHTHOUSE_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_SP_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_SP_EDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_EA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_EA_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_NON_EN_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_NON_EN_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_EDITED, TEXT_GEN_SUGGESTION_LLM_DF_LLAMA4_ARPG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DF_LLAMA4_ARPG_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V0_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V0_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_BASED_GEN_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_BASED_GEN_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_SEQUENTIAL_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_SEQUENTIAL_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_MM_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_MM_EDITED, TEXT_GEN_SUGGESTION_LLM_PPO_TEXT_IMAGE_RM_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PPO_TEXT_IMAGE_RM_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_LLAMA4_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_LLAMA4_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_GPT4O_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_GPT4O_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_HISTORICAL_ADS_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_HISTORICAL_ADS_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_COMPOUND_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_COMPOUND_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_GPT4O_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_GPT4O_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_COMPOUND_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_COMPOUND_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_DEEPER_FUNNEL_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_DEEPER_FUNNEL_EDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_SEGMENT_PROMPT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_SEGMENT_PROMPT_EDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_COMPOUND_UNEDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_COMPOUND_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_1_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_LLAMA4_ARPG_HOOK_BUNDLE_V0_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_LLAMA4_ARPG_HOOK_BUNDLE_V0_EDITED, TEXT_GEN_SUGGESTION_LLM_IF_MORL_25H2_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_IF_MORL_25H2_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_LANDING_PAGE_CONTEXT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_LANDING_PAGE_CONTEXT_EDITED, TEXT_GEN_SUGGESTION_LLM_GPT4O_LANDING_PAGE_CONTEXT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_GPT4O_LANDING_PAGE_CONTEXT_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V0_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V0_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_TRANSLATION_V1, TEXT_FIRST_MANUAL_OPTION, TEXT_AUTO_TRANSLATION_MT_V1, TEXT_AUTO_TRANSLATION_LLM_V1, TEXT_TRANSLATIONS_LLAMA4_V1_TITLE, TEXT_TRANSLATIONS_LLAMA4_V1_BODY, TEXT_AD_HIGHLIGHT, PROMINENT_HEADLINE_NO_SHOW, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_1, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_2, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_3, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_4, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_5, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_ABSTRACTIVE, TEXT_GEN_AUTOMATION, TEXT_GEN_AUTOMATION_ALPHA_DEEPER_FUNNEL_USER_COHORT_BATCH_GENERATION, TEXT_GEN_AUTOMATION_ALPHA_BRAND_ALIGNER_USER_COHORT_SEQUENTIAL_GENERATION, TEXT_GEN_AUTOMATION_ALPHA_BRAND_ALIGNER_USER_COHORT_BATCH_GENERATION, TEXT_GEN_AUTOMATION_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_UNEDITED, TEXT_GEN_AUTOMATION_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_EDITED, TEXT_GEN_AUTOMATION_REVIEWED_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_UNEDITED, TEXT_GEN_AUTOMATION_REVIEWED_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_MOCK_UNEDITED, TEXT_GEN_SUGGESTION_MOCK_EDITED, TEXT_GEN_SUGGESTION_MOCK_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_MOCK_EDITED_BEFORE_AND_AFTER_ADD} automation_status enum {OPT_IN, OPT_OUT} uuid string supports emoji text_gen_original_text string supports emoji language string target_audience string tracking_tag list<enum {NONE, TEXT_GEN_LLM_PERSONA_EDITED_TAG}> text_gen_input_text string supports emoji type enum {TEMPLATE} action_type enum {DEFAULT_ADD, DEFAULT_ADD_INTERACTION, MANUAL_ADD, STICKY_ADD, STICKY_ADD_INTERACTION, TEXT_AUTOMATION_DEFAULT_ADD, TEXT_AUTOMATION_DEFAULT_ADD_INTERACTION, TEXT_AUTOMATION_MANUAL_ADD, TEXT_AUTOMATION_STICKY_ADD, TEXT_AUTOMATION_STICKY_ADD_INTERACTION} Show child parameters call_to_action_types list<enum{OPEN_LINK, LIKE_PAGE, SHOP_NOW, PLAY_GAME, INSTALL_APP, USE_APP, CALL, CALL_ME, VIDEO_CALL, INSTALL_MOBILE_APP, USE_MOBILE_APP, MOBILE_DOWNLOAD, BOOK_TRAVEL, LISTEN_MUSIC, WATCH_VIDEO, LEARN_MORE, SIGN_UP, DOWNLOAD, WATCH_MORE, NO_BUTTON, VISIT_PAGES_FEED, CALL_NOW, APPLY_NOW, CONTACT, BUY_NOW, GET_OFFER, GET_OFFER_VIEW, BUY_TICKETS, UPDATE_APP, GET_DIRECTIONS, BUY, SEND_UPDATES, MESSAGE_PAGE, DONATE, SUBSCRIBE, SAY_THANKS, SELL_NOW, SHARE, DONATE_NOW, GET_QUOTE, CONTACT_US, ORDER_NOW, START_ORDER, ADD_TO_CART, VIEW_CART, VIEW_IN_CART, VIDEO_ANNOTATION, RECORD_NOW, INQUIRE_NOW, CONFIRM, REFER_FRIENDS, REQUEST_TIME, GET_SHOWTIMES, LISTEN_NOW, TRY_DEMO, WOODHENGE_SUPPORT, SOTTO_SUBSCRIBE, FOLLOW_USER, RAISE_MONEY, SEE_SHOP, GET_DETAILS, FIND_OUT_MORE, VISIT_WEBSITE, BROWSE_SHOP, EVENT_RSVP, WHATSAPP_MESSAGE, FOLLOW_NEWS_STORYLINE, SEE_MORE, BOOK_NOW, FIND_A_GROUP, FIND_YOUR_GROUPS, PAY_TO_ACCESS, PURCHASE_GIFT_CARDS, FOLLOW_PAGE, SEND_A_GIFT, SWIPE_UP_SHOP, SWIPE_UP_PRODUCT, SEND_GIFT_MONEY, PLAY_GAME_ON_FACEBOOK, GET_STARTED, OPEN_INSTANT_APP, AUDIO_CALL, GET_PROMOTIONS, JOIN_CHANNEL, MAKE_AN_APPOINTMENT, ASK_ABOUT_SERVICES, BOOK_A_CONSULTATION, GET_A_QUOTE, BUY_VIA_MESSAGE, ASK_FOR_MORE_INFO, CHAT_WITH_US, VIEW_PRODUCT, VIEW_CHANNEL, GET_IN_TOUCH, ASK_A_QUESTION, START_A_CHAT, CHAT_NOW, ASK_US, WATCH_LIVE_VIDEO, JOIN_LIVE_VIDEO, SHOP_WITH_AI, TRY_ON_WITH_AI}> descriptions list<Object> --- text string supports emoji url_tags string adlabels list<Object> translation_confidence int64 asset_source enum {ACO_TEXT_LIBRARY, TEXT_GEN_INPUT_TEXT, TEXT_GEN_SUGGESTION_DIVERSITY_UNEDITED, TEXT_GEN_SUGGESTION_DIVERSITY_EDITED, TEXT_GEN_SUGGESTION_DIVERSITY_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_DIVERSITY_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_PARAPHRASING_UNEDITED, TEXT_GEN_SUGGESTION_PARAPHRASING_EDITED, TEXT_GEN_SUGGESTION_PARAPHRASING_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_PARAPHRASING_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNEDITED, TEXT_GEN_SUGGESTION_LLM_EDITED, TEXT_GEN_SUGGESTION_LLM_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_UNEDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_EDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_EDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_UNEDITED, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_EDITED, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_ORCHESTRATOR_MULTILINGUAL_UNEDITED, TEXT_GEN_SUGGESTION_ORCHESTRATOR_MULTILINGUAL_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_LLM_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_LLM_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_1_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_2_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_2_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_SINGLE_STAGE_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_V_1_1_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_ORCHESTRATOR_V_1_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_ORCHESTRATOR_V_1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_LONG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_LONG_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_LONG_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_LONG_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V3_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V3_EDITED, TEXT_GEN_SUGGESTION_LLM_V3_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V3_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V3_LONG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V3_LONG_EDITED, TEXT_GEN_SUGGESTION_LLM_V3_LONG_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V3_LONG_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_FOR_IG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_FOR_IG_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_UNEDITED, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_EDITED, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V3_UNEDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V3_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_FOR_FB_UNEDITED, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_FOR_FB_EDITED, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_HEURISTICS_V1_UNEDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_HEURISTICS_V1_EDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_LLAMA4_HOOKS_UNEDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_LLAMA4_HOOKS_EDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_GPT_OSS_HOOKS_UNEDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_GPT_OSS_HOOKS_EDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_OSS_BUNDLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_OSS_BUNDLE_EDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_L4BASE_BUNDLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_L4BASE_BUNDLE_EDITED, TEXT_GEN_SUGGESTION_PPO_ORCHESTRATOR_V1_UNEDITED, TEXT_GEN_SUGGESTION_PPO_ORCHESTRATOR_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_ALIGNER_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_ALIGNER_EDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_PRIMARY_TEXT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_PRIMARY_TEXT_EDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_HISTORICAL_ADS_UNEDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_HISTORICAL_ADS_EDITED, TEXT_GEN_SUGGESTION_LLM_FREEFORM_BRAND_TONE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_FREEFORM_BRAND_TONE_EDITED, TEXT_GEN_SUGGESTION_LLM_COHORT_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_COHORT_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_LIGHTHOUSE_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LIGHTHOUSE_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_SP_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_SP_EDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_EA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_EA_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_NON_EN_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_NON_EN_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_EDITED, TEXT_GEN_SUGGESTION_LLM_DF_LLAMA4_ARPG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DF_LLAMA4_ARPG_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V0_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V0_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_BASED_GEN_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_BASED_GEN_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_SEQUENTIAL_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_SEQUENTIAL_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_MM_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_MM_EDITED, TEXT_GEN_SUGGESTION_LLM_PPO_TEXT_IMAGE_RM_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PPO_TEXT_IMAGE_RM_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_LLAMA4_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_LLAMA4_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_GPT4O_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_GPT4O_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_HISTORICAL_ADS_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_HISTORICAL_ADS_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_COMPOUND_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_COMPOUND_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_GPT4O_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_GPT4O_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_COMPOUND_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_COMPOUND_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_DEEPER_FUNNEL_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_DEEPER_FUNNEL_EDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_SEGMENT_PROMPT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_SEGMENT_PROMPT_EDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_COMPOUND_UNEDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_COMPOUND_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_1_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_LLAMA4_ARPG_HOOK_BUNDLE_V0_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_LLAMA4_ARPG_HOOK_BUNDLE_V0_EDITED, TEXT_GEN_SUGGESTION_LLM_IF_MORL_25H2_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_IF_MORL_25H2_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_LANDING_PAGE_CONTEXT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_LANDING_PAGE_CONTEXT_EDITED, TEXT_GEN_SUGGESTION_LLM_GPT4O_LANDING_PAGE_CONTEXT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_GPT4O_LANDING_PAGE_CONTEXT_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V0_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V0_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_TRANSLATION_V1, TEXT_FIRST_MANUAL_OPTION, TEXT_AUTO_TRANSLATION_MT_V1, TEXT_AUTO_TRANSLATION_LLM_V1, TEXT_TRANSLATIONS_LLAMA4_V1_TITLE, TEXT_TRANSLATIONS_LLAMA4_V1_BODY, TEXT_AD_HIGHLIGHT, PROMINENT_HEADLINE_NO_SHOW, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_1, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_2, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_3, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_4, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_5, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_ABSTRACTIVE, TEXT_GEN_AUTOMATION, TEXT_GEN_AUTOMATION_ALPHA_DEEPER_FUNNEL_USER_COHORT_BATCH_GENERATION, TEXT_GEN_AUTOMATION_ALPHA_BRAND_ALIGNER_USER_COHORT_SEQUENTIAL_GENERATION, TEXT_GEN_AUTOMATION_ALPHA_BRAND_ALIGNER_USER_COHORT_BATCH_GENERATION, TEXT_GEN_AUTOMATION_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_UNEDITED, TEXT_GEN_AUTOMATION_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_EDITED, TEXT_GEN_AUTOMATION_REVIEWED_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_UNEDITED, TEXT_GEN_AUTOMATION_REVIEWED_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_MOCK_UNEDITED, TEXT_GEN_SUGGESTION_MOCK_EDITED, TEXT_GEN_SUGGESTION_MOCK_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_MOCK_EDITED_BEFORE_AND_AFTER_ADD} automation_status enum {OPT_IN, OPT_OUT} tracking_tag list<enum {NONE, TEXT_GEN_LLM_PERSONA_EDITED_TAG}> uuid string supports emoji text_gen_original_text string supports emoji language string target_audience string text_gen_input_text string supports emoji action_type enum {DEFAULT_ADD, DEFAULT_ADD_INTERACTION, MANUAL_ADD, STICKY_ADD, STICKY_ADD_INTERACTION, TEXT_AUTOMATION_DEFAULT_ADD, TEXT_AUTOMATION_DEFAULT_ADD_INTERACTION, TEXT_AUTOMATION_MANUAL_ADD, TEXT_AUTOMATION_STICKY_ADD, TEXT_AUTOMATION_STICKY_ADD_INTERACTION} type enum {TEMPLATE} Show child parameters link_urls list<Object> --- website_url URL display_url string deeplink_url string carousel_see_more_url URL url_tags string adlabels list<Object> type enum {TEMPLATE} omnichannel_link_spec JSON or object-like arrays --- web JSON or object-like arrays --- url string Show child parameters app JSON or object-like arrays --- application_id int64 platform_specs Object --- android Object --- app_name string package_name string url string Show child parameters ios Object --- app_name string app_store_id string url string Show child parameters ipad Object --- app_name string app_store_id string url string Show child parameters iphone Object --- app_name string app_store_id string url string Show child parameters Show child parameters Show child parameters Show child parameters object_store_urls list<string> android_url string ios_url string Show child parameters titles list<Object> --- text string supports emoji url_tags string adlabels list<Object> translation_confidence int64 asset_source enum {ACO_TEXT_LIBRARY, TEXT_GEN_INPUT_TEXT, TEXT_GEN_SUGGESTION_DIVERSITY_UNEDITED, TEXT_GEN_SUGGESTION_DIVERSITY_EDITED, TEXT_GEN_SUGGESTION_DIVERSITY_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_DIVERSITY_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_PARAPHRASING_UNEDITED, TEXT_GEN_SUGGESTION_PARAPHRASING_EDITED, TEXT_GEN_SUGGESTION_PARAPHRASING_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_PARAPHRASING_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNEDITED, TEXT_GEN_SUGGESTION_LLM_EDITED, TEXT_GEN_SUGGESTION_LLM_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_V_1_2_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_UNEDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_UNEDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_EDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_EDITED, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_BRAND_IDENTITY_V_1_1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_UNEDITED, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_EDITED, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_ORCHESTRATOR_V_1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_ORCHESTRATOR_MULTILINGUAL_UNEDITED, TEXT_GEN_SUGGESTION_ORCHESTRATOR_MULTILINGUAL_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_LLM_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_LLM_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_1_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_2_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_V_1_2_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_SINGLE_STAGE_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_SEMANTIC_VARIATIONS_SINGLE_STAGE_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_V_1_1_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_BRAND_IDENTITY_V_1_1_UNEDITED, TEXT_GEN_SUGGESTION_GUIDANCE_ORCHESTRATOR_V_1_EDITED, TEXT_GEN_SUGGESTION_GUIDANCE_ORCHESTRATOR_V_1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_LONG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_LONG_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_LONG_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_LONG_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_EDITED, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V2_DPO_PPO_LONG_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V3_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V3_EDITED, TEXT_GEN_SUGGESTION_LLM_V3_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V3_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_V3_LONG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_V3_LONG_EDITED, TEXT_GEN_SUGGESTION_LLM_V3_LONG_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_V3_LONG_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_FOR_IG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_FOR_IG_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_V2_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_UNEDITED, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_EDITED, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_APP_DESCRIPTION_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V3_UNEDITED, TEXT_GEN_SUGGESTION_LLM_ORCHESTRATOR_V3_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_LC_PPO_LLAMA3_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_FOR_FB_UNEDITED, TEXT_GEN_SUGGESTION_LLM_FC_PPO_LLAMA3_V1_FOR_FB_EDITED, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_SFT_LLAMA3_V1_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_HEURISTICS_V1_UNEDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_HEURISTICS_V1_EDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_LLAMA4_HOOKS_UNEDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_LLAMA4_HOOKS_EDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_GPT_OSS_HOOKS_UNEDITED, TEXT_GEN_SUGGESTION_ADS_MANAGER_LLM_HEADLINE_GPT_OSS_HOOKS_EDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_OSS_BUNDLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_OSS_BUNDLE_EDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_L4BASE_BUNDLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_HEADLINE_ARPG_L4BASE_BUNDLE_EDITED, TEXT_GEN_SUGGESTION_PPO_ORCHESTRATOR_V1_UNEDITED, TEXT_GEN_SUGGESTION_PPO_ORCHESTRATOR_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_ALIGNER_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_ALIGNER_EDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_PRIMARY_TEXT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_PRIMARY_TEXT_EDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_HISTORICAL_ADS_UNEDITED, TEXT_GEN_SUGGESTION_LLM_IMPLICIT_BRAND_TONE_HISTORICAL_ADS_EDITED, TEXT_GEN_SUGGESTION_LLM_FREEFORM_BRAND_TONE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_FREEFORM_BRAND_TONE_EDITED, TEXT_GEN_SUGGESTION_LLM_COHORT_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_COHORT_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_LIGHTHOUSE_LLAMA3_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LIGHTHOUSE_LLAMA3_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_SP_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_SP_EDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_EA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PURPOSEFUL_GEN_EA_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_NON_EN_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_NON_EN_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_EDITED, TEXT_GEN_SUGGESTION_LLM_DF_LLAMA4_ARPG_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DF_LLAMA4_ARPG_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V0_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V0_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_TEMPLATE_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_BASED_GEN_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_BASED_GEN_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_SEQUENTIAL_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_SEQUENTIAL_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_MM_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_MM_EDITED, TEXT_GEN_SUGGESTION_LLM_PPO_TEXT_IMAGE_RM_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PPO_TEXT_IMAGE_RM_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_LLAMA4_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_LLAMA4_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_GPT4O_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_GPT4O_EDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_HISTORICAL_ADS_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_BRAND_HISTORICAL_ADS_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_COMPOUND_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_V2_COMPOUND_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_GPT4O_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_GPT4O_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_COMPOUND_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_EDITABLE_COMPOUND_EDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_DEEPER_FUNNEL_UNEDITED, TEXT_GEN_SUGGESTION_LLM_PERSONA_DEEPER_FUNNEL_EDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_TARGET_PERSONA_BASED_GEN_BUNDLED_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_SEGMENT_PROMPT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_SEGMENT_PROMPT_EDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_COMPOUND_UNEDITED, TEXT_GEN_SUGGESTION_LLM_CONVERTER_BASED_PERSONA_COMPOUND_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_1_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_LLAMA4_ARPG_HOOK_BUNDLE_V0_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_LLAMA4_ARPG_HOOK_BUNDLE_V0_EDITED, TEXT_GEN_SUGGESTION_LLM_IF_MORL_25H2_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_IF_MORL_25H2_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_LANDING_PAGE_CONTEXT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_LLAMA4_LANDING_PAGE_CONTEXT_EDITED, TEXT_GEN_SUGGESTION_LLM_GPT4O_LANDING_PAGE_CONTEXT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_GPT4O_LANDING_PAGE_CONTEXT_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V0_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V0_EDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V1_UNEDITED, TEXT_GEN_SUGGESTION_LLM_DEEPER_FUNNEL_PPO_HOOK_RM_V1_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_V2_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_MULTILINGUAL_DEEPER_FUNNEL_PPO_LLAMA3_V2_EDITED, TEXT_GEN_SUGGESTION_LLM_TRANSLATION_V1, TEXT_FIRST_MANUAL_OPTION, TEXT_AUTO_TRANSLATION_MT_V1, TEXT_AUTO_TRANSLATION_LLM_V1, TEXT_TRANSLATIONS_LLAMA4_V1_TITLE, TEXT_TRANSLATIONS_LLAMA4_V1_BODY, TEXT_AD_HIGHLIGHT, PROMINENT_HEADLINE_NO_SHOW, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_1, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_2, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_3, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_4, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_TIER_5, TEXT_LIQUIDITY_BODY_WITH_PROMINENT_HEADLINE_ABSTRACTIVE, TEXT_GEN_AUTOMATION, TEXT_GEN_AUTOMATION_ALPHA_DEEPER_FUNNEL_USER_COHORT_BATCH_GENERATION, TEXT_GEN_AUTOMATION_ALPHA_BRAND_ALIGNER_USER_COHORT_SEQUENTIAL_GENERATION, TEXT_GEN_AUTOMATION_ALPHA_BRAND_ALIGNER_USER_COHORT_BATCH_GENERATION, TEXT_GEN_AUTOMATION_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_UNEDITED, TEXT_GEN_AUTOMATION_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_EDITED, TEXT_GEN_AUTOMATION_REVIEWED_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_UNEDITED, TEXT_GEN_AUTOMATION_REVIEWED_DEEPER_FUNNEL_PPO_SEQUENTIAL_TWO_STAGE_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_PERSONA_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_SELLING_POINT_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_PERSONA_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_SELLING_POINT_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_HEADLINE_WITH_MARKETING_ANGLE_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_UNEDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_EDITED, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_LLM_UNIFIED_PRIMARY_TEXT_WITH_MARKETING_ANGLE_EDITED_BEFORE_AND_AFTER_ADD, TEXT_GEN_SUGGESTION_MOCK_UNEDITED, TEXT_GEN_SUGGESTION_MOCK_EDITED, TEXT_GEN_SUGGESTION_MOCK_EDITED_BEFORE_ADD, TEXT_GEN_SUGGESTION_MOCK_EDITED_BEFORE_AND_AFTER_ADD} automation_status enum {OPT_IN, OPT_OUT} uuid string supports emoji text_gen_original_text string supports emoji language string target_audience string text_gen_input_text string supports emoji action_type enum {DEFAULT_ADD, DEFAULT_ADD_INTERACTION, MANUAL_ADD, STICKY_ADD, STICKY_ADD_INTERACTION, TEXT_AUTOMATION_DEFAULT_ADD, TEXT_AUTOMATION_DEFAULT_ADD_INTERACTION, TEXT_AUTOMATION_MANUAL_ADD, TEXT_AUTOMATION_STICKY_ADD, TEXT_AUTOMATION_STICKY_ADD_INTERACTION} type enum {TEMPLATE} tracking_tag list<enum {NONE, TEXT_GEN_LLM_PERSONA_EDITED_TAG}> Show child parameters captions list<Object> --- text string url_tags string adlabels list<Object> type enum {TEMPLATE} Show child parameters ad_formats list<enum {AUTOMATIC_FORMAT, CAROUSEL, CAROUSEL_IMAGE, CAROUSEL_VIDEO, COLLECTION, SINGLE_IMAGE, SINGLE_VIDEO, POST}> groups list<JSON or object-like arrays> --- image_label Object video_label Object body_label Object description_label Object link_url_label Object title_label Object caption_label Object Show child parameters target_rules list<JSON or object-like arrays> --- targeting JSON or object-like arrays --- age_min int64 age_max int64 audience_network_positions list<enum{classic, rewarded_video, instream_video}> device_platforms list<enum{desktop, mobile}> facebook_positions list<enum{feed, instant_article, instream_video, marketplace, right_hand_column, search, story, suggested_video, video_feeds, story_sticker, facebook_reels_overlay, biz_disco_feed, facebook_reels, profile_feed, profile_reels, notification}> instagram_positions list<enum{reels, reels_overlay, stream, story, explore, explore_home, ig_search, shop, profile_feed, profile_reels, effect_tray}> messenger_positions list<enum{messenger_home, story, marketing_messages}> threads_positions list<enum{threads_stream}> genders list<int64> publisher_platforms list<enum{facebook, instagram, audience_network, messenger, oculus, whatsapp, threads}> interests list<JSON or object-like arrays> --- id int64 name string Show child parameters behaviors list<JSON or object-like arrays> --- id int64 name string Show child parameters Show child parameters customization_spec JSON or object-like arrays --- age_min int64 age_max int64 audience_network_positions list<enum{classic, rewarded_video, instream_video}> device_platforms list<enum{desktop, mobile}> facebook_positions list<enum{feed, instant_article, instream_video, marketplace, right_hand_column, search, story, suggested_video, video_feeds, story_sticker, facebook_reels_overlay, biz_disco_feed, facebook_reels, profile_feed, profile_reels, notification}> instagram_positions list<enum{reels, reels_overlay, stream, story, explore, explore_home, ig_search, shop, profile_feed, profile_reels, effect_tray}> genders list<int64> publisher_platforms list<enum{facebook, instagram, audience_network, messenger, oculus, whatsapp, threads}> interests list<JSON or object-like arrays> --- id int64 name string Show child parameters behaviors list<JSON or object-like arrays> --- id int64 name string Show child parameters geo_locations JSON object marketing_message_channels list<enum{whatsapp, messenger}> Show child parameters image_label Object video_label Object body_label Object description_label Object link_url_label Object title_label Object caption_label Object call_to_action_label Object carousel_label Object priority int64 is_default boolean Show child parameters asset_customization_rules list<JSON or object-like arrays> --- targeting JSON or object-like arrays --- age_min int64 age_max int64 audience_network_positions list<enum{classic, rewarded_video, instream_video}> device_platforms list<enum{desktop, mobile}> facebook_positions list<enum{feed, instant_article, instream_video, marketplace, right_hand_column, search, story, suggested_video, video_feeds, story_sticker, facebook_reels_overlay, biz_disco_feed, facebook_reels, profile_feed, profile_reels, notification}> instagram_positions list<enum{reels, reels_overlay, stream, story, explore, explore_home, ig_search, shop, profile_feed, profile_reels, effect_tray}> messenger_positions list<enum{messenger_home, story, marketing_messages}> threads_positions list<enum{threads_stream}> genders list<int64> publisher_platforms list<enum{facebook, instagram, audience_network, messenger, oculus, whatsapp, threads}> interests list<JSON or object-like arrays> --- id int64 name string Show child parameters behaviors list<JSON or object-like arrays> --- id int64 name string Show child parameters Show child parameters customization_spec JSON or object-like arrays --- age_min int64 age_max int64 audience_network_positions list<enum{classic, rewarded_video, instream_video}> device_platforms list<enum{desktop, mobile}> facebook_positions list<enum{feed, instant_article, instream_video, marketplace, right_hand_column, search, story, suggested_video, video_feeds, story_sticker, facebook_reels_overlay, biz_disco_feed, facebook_reels, profile_feed, profile_reels, notification}> instagram_positions list<enum{reels, reels_overlay, stream, story, explore, explore_home, ig_search, shop, profile_feed, profile_reels, effect_tray}> genders list<int64> publisher_platforms list<enum{facebook, instagram, audience_network, messenger, oculus, whatsapp, threads}> interests list<JSON or object-like arrays> --- id int64 name string Show child parameters behaviors list<JSON or object-like arrays> --- id int64 name string Show child parameters geo_locations JSON object marketing_message_channels list<enum{whatsapp, messenger}> Show child parameters image_label Object video_label Object body_label Object description_label Object link_url_label Object title_label Object caption_label Object call_to_action_label Object carousel_label Object priority int64 is_default boolean Show child parameters optimization_type enum{REGULAR, LANGUAGE, PLACEMENT, BRAND, LOCALIZED_PLACEMENTS, FORMAT_AUTOMATION, DOF_MESSAGING_DESTINATION, ACO_AUTOFLOW, MULTI_CREATOR, UNIFIED_PROFILE_VISIT_DESTINATION} call_to_actions list<Object> --- type enum{BOOK_TRAVEL, CONTACT_US, DONATE, DONATE_NOW, DOWNLOAD, GET_DIRECTIONS, GO_LIVE, INTERESTED, LEARN_MORE, SEE_DETAILS, LIKE_PAGE, MESSAGE_PAGE, RAISE_MONEY, SAVE, SEND_TIP, SHOP_NOW, SIGN_UP, VIEW_INSTAGRAM_PROFILE, INSTAGRAM_MESSAGE, LOYALTY_LEARN_MORE, PURCHASE_GIFT_CARDS, PAY_TO_ACCESS, SEE_MORE, TRY_IN_CAMERA, WHATSAPP_LINK, GET_IN_TOUCH, TRY_NOW, ASK_A_QUESTION, START_A_CHAT, CHAT_NOW, ASK_US, CHAT_WITH_US, BOOK_NOW, CHECK_AVAILABILITY, ORDER_NOW, WHATSAPP_MESSAGE, GET_MOBILE_APP, INSTALL_MOBILE_APP, USE_MOBILE_APP, INSTALL_APP, USE_APP, PLAY_GAME, TRY_DEMO, WATCH_VIDEO, WATCH_MORE, OPEN_LINK, NO_BUTTON, LISTEN_MUSIC, MOBILE_DOWNLOAD, GET_OFFER, GET_OFFER_VIEW, BUY_NOW, BUY_TICKETS, UPDATE_APP, BET_NOW, ADD_TO_CART, SELL_NOW, GET_SHOWTIMES, LISTEN_NOW, GET_EVENT_TICKETS, REMIND_ME, SEARCH_MORE, PRE_REGISTER, SWIPE_UP_PRODUCT, SWIPE_UP_SHOP, PLAY_GAME_ON_FACEBOOK, VISIT_WORLD, OPEN_INSTANT_APP, JOIN_GROUP, GET_PROMOTIONS, SEND_UPDATES, INQUIRE_NOW, VISIT_PROFILE, CHAT_ON_WHATSAPP, EXPLORE_MORE, CONFIRM, JOIN_CHANNEL, MAKE_AN_APPOINTMENT, ASK_ABOUT_SERVICES, BOOK_A_CONSULTATION, GET_A_QUOTE, BUY_VIA_MESSAGE, ASK_FOR_MORE_INFO, VIEW_PRODUCT, VIEW_CHANNEL, WATCH_LIVE_VIDEO, JOIN_LIVE_VIDEO, IMAGINE, CALL, MISSED_CALL, CALL_NOW, CALL_ME, APPLY_NOW, BUY, GET_QUOTE, SUBSCRIBE, RECORD_NOW, VOTE_NOW, GIVE_FREE_RIDES, REGISTER_NOW, OPEN_MESSENGER_EXT, EVENT_RSVP, CIVIC_ACTION, SEND_INVITES, REFER_FRIENDS, REQUEST_TIME, SEE_MENU, SEARCH, TRY_IT, TRY_ON, LINK_CARD, DIAL_CODE, FIND_YOUR_GROUPS, START_ORDER} required value Object supports emoji --- android_url string ios_url string link URL app_link string page numeric string or integer link_format enum {VIDEO_LEAD, VIDEO_LPP, VIDEO_NEKO, VIDEO_NON_LINK, VIDEO_SHOP, WHATSAPP_CATALOG_ATTACHMENT} application numeric string or integer link_title string supports emoji link_description string supports emoji link_caption string product_link string get_movie_showtimes boolean sponsorship Object --- link URL image URL Show child parameters video_annotation Object --- annotations list<Object> --- start_time_in_sec int64 end_time_in_sec int64 link URL link_title string link_description string link_caption string image_url URL Show child parameters header_color string logo_url URL post_click_cta_title string post_click_description_title string Show child parameters offer_id numeric string or integer offer_view_id numeric string or integer advanced_data Object --- offer_id numeric string or integer Show child parameters lead_gen_form_id numeric string or integer referral_id numeric string or integer search_dialog_id numeric string or integer fundraiser_campaign_id numeric string or integer event_id numeric string or integer event_tour_id numeric string or integer app_destination enum {MESSENGER, MESSENGER_EXTENSIONS, MESSENGER_GAMES, LINK_CARD, MARKETPLACE, WHATSAPP, INSTAGRAM_DIRECT, INSTAGRAM_LIVE_VIDEO, FACEBOOK_LIVE_VIDEO} app_destination_page_id numeric string or integer is_canvas_video_transition_enabled boolean whatsapp_number string preinput_text string customized_message_page_cta_text string external_offer_provider_id numeric string or integer origins enum {COMPOSER, CAMERA} object_store_urls array<string> facebook_login_spec Object --- facebook_login_app_id numeric string or integer offer_type enum {NO_OFFER, PERCENTAGE_BASED, AMOUNT_BASED} offer_pct_call_to_action enum {TEN} offer_amt_call_to_action enum {TEN} Show child parameters product_id numeric string or integer group_id numeric string or integer channel_id string land_on_whatsapp_catalog enum{1, 2} land_on_whatsapp_profile string Show child parameters adlabels list<Object> Show child parameters autotranslate array<string> additional_data JSON object carousels list<JSON or object-like arrays> --- multi_share_end_card boolean Default value: false multi_share_optimized boolean Default value: false child_attachments list<JSON or object-like arrays> Default value: Vec required --- image_label Object video_label Object body_label Object call_to_action_type_label Object description_label Object link_url_label Object title_label Object phone_data_ids_label Object static_card boolean Show child parameters adlabels list<Object> Show child parameters audios list<Object> --- type enum {OPTED_OUT, RANDOM, SELECTED} selected_audios array<JSON object> is_audio_swap boolean Show child parameters app_product_page_id string promotional_metadata Object --- allowed_coupon_code_sources array<enum {PROVIDED_BY_MERCHANT, PROVIDED_BY_MERCHANT_OFFER_MANAGEMENT, DETECTED_FROM_MERCHANT_ADS, DETECTED_FROM_MERCHANT_WEBSITE, DETECTED_FROM_MERCHANT_WEBSITE_URL, AD_CREATIVE_PRIMARY_TEXT, AD_CREATIVE_HEADLINE, AD_CREATIVE_DESCRIPTION, AD_CREATIVE_PRIMARY_TEXT_LLM, AD_CREATIVE_HEADLINE_LLM, AD_CREATIVE_DESCRIPTION_LLM, AD_CREATIVE_MANUAL_COUPON_CODES, EMAIL_CAPTURE_SHOPIFY, EMAIL_CAPTURE_NON_SHOPIFY, EMAIL_CAPTURE_GENERIC_CODE, WA_CAPTURE_GENERIC_CODE, DETECTED_FROM_MERCHANT_EMAIL_SIGNUP, PDO_MERCHANT_EMAIL_SIGNUP}> allowed_promo_offer_ids array<numeric string> product_catalog_id numeric string product_catalog_id_for_email_capture numeric string manual_coupon_codes array<string> is_auto_update_allowed boolean coupon_codes JSON object {enum {PROVIDED_BY_MERCHANT, PROVIDED_BY_MERCHANT_OFFER_MANAGEMENT, DETECTED_FROM_MERCHANT_ADS, DETECTED_FROM_MERCHANT_WEBSITE, DETECTED_FROM_MERCHANT_WEBSITE_URL, AD_CREATIVE_PRIMARY_TEXT, AD_CREATIVE_HEADLINE, AD_CREATIVE_DESCRIPTION, AD_CREATIVE_PRIMARY_TEXT_LLM, AD_CREATIVE_HEADLINE_LLM, AD_CREATIVE_DESCRIPTION_LLM, AD_CREATIVE_MANUAL_COUPON_CODES, EMAIL_CAPTURE_SHOPIFY, EMAIL_CAPTURE_NON_SHOPIFY, EMAIL_CAPTURE_GENERIC_CODE, WA_CAPTURE_GENERIC_CODE, DETECTED_FROM_MERCHANT_EMAIL_SIGNUP, PDO_MERCHANT_EMAIL_SIGNUP} : array<string>} offer_details array<JSON object> excluded_offers array<string> pre_click_ad_containers array<enum {FACEBOOK_EBM, INSTAGRAM_REELS_MIDSCENE, INSTAGRAM_STORIES_CTA}> Show child parameters web_destination_spec Object --- url URL Show child parameters call_ads_configuration Object --- agent_greeting string auto_response string bizai_config string greeting_audio_url string call_destination_type enum{PHONE, MESSENGER, MESSENGER_AND_PHONE, WEBSITE_AND_CALL, WHATSAPP, WHATSAPP_ORGANIC} callback_type enum{FORM, NOT_ENABLED, MESSENGER} call_forwarding enum{ENABLED, DISABLED} call_transcript enum{ENABLED, DISABLED} phone_number string recording_consent enum{TRANSCRIPTION_ENABLED, DISABLED} Show child parameters lead_gen_configuration Object --- is_form_qa_enabled boolean is_work_email_enforcement_enabled boolean verification_type enum{NOT_ENABLED, SMS} Show child parameters Show child parameters |
authorization_category enum{NONE, POLITICAL, POLITICAL_WITH_DIGITALLY_CREATED_MEDIA} | Specifies whether ad is political or not. If your ad has political content, set this to POLITICAL, otherwise it defaults to null. Your ad will be disapproved if it contains political content but not labeled POLITICAL. See Facebook Advertising Policies. This field cannot be used for Dynamic Ads. |
body string | The body of the ad. supports emoji |
branded_content JSON object | branded_content --- partners array<JSON object> partners --- fb_page_id numeric string fb_page_id ig_user_id numeric string ig_user_id ig_asset_id numeric string ig_asset_id identity_type enum {ADVERTISER, PARTNER_BUSINESS, PARTNER_CREATOR} identity_type has_create_ads_access boolean has_create_ads_access Show child parameters ui_version int64 ui_version instagram_boost_post_access_token string instagram_boost_post_access_token ad_format enum {0, 1, 2, 3} ad_format creator_ad_permission_type enum {AUTOMATION_BRIEFS_PERMISSION, FB_ADS_PERMISSION, FB_AFFILIATE_ADS_PERMISSION, FB_ORGANIC_PERMISSION, FB_POST_PERMISSION, FB_PRODUCT_TAG_PERMISSION, IG_ADS_PERMISSION, IG_ADS_PERMISSION_DIRECTION_AGNOSTIC, IG_ORGANIC_PERMISSION, IG_POST_PERMISSION, SAME_BUSINESS_PERMISSION, UGC_CREATOR_PAYMENTS_PERMISSION} creator_ad_permission_type is_mca_internal boolean is_mca_internal promoted_page_id numeric string promoted_page_id facebook_boost_post_access_token string facebook_boost_post_access_token content_search_input string content_search_input testimonial string testimonial product_set_partner_selection_status enum {OPT_IN, OPT_OUT} product_set_partner_selection_status parent_source_instagram_media_id numeric string parent_source_instagram_media_id parent_source_facebook_post_id numeric string parent_source_facebook_post_id testimonial_locale string testimonial_locale acting_business_id numeric string acting_business_id deliver_dynamic_partner_content boolean deliver_dynamic_partner_content automated_adgroup_creation boolean automated_adgroup_creation content_list JSON object content_list --- id numeric string id import_time datetime/timestamp import_time Show child parameters Show child parameters |
branded_content_sponsor_page_id numeric string or integer | ID for page representing business which runs Branded Content ads. See Creating Branded Content Ads. |
bundle_folder_id numeric string or integer | The Dynamic Ad's bundle folder ID |
call_to_action Object | This field promotes an onsite or offsite action. supports emoji --- type enum{BOOK_TRAVEL, CONTACT_US, DONATE, DONATE_NOW, DOWNLOAD, GET_DIRECTIONS, GO_LIVE, INTERESTED, LEARN_MORE, SEE_DETAILS, LIKE_PAGE, MESSAGE_PAGE, RAISE_MONEY, SAVE, SEND_TIP, SHOP_NOW, SIGN_UP, VIEW_INSTAGRAM_PROFILE, INSTAGRAM_MESSAGE, LOYALTY_LEARN_MORE, PURCHASE_GIFT_CARDS, PAY_TO_ACCESS, SEE_MORE, TRY_IN_CAMERA, WHATSAPP_LINK, GET_IN_TOUCH, TRY_NOW, ASK_A_QUESTION, START_A_CHAT, CHAT_NOW, ASK_US, CHAT_WITH_US, BOOK_NOW, CHECK_AVAILABILITY, ORDER_NOW, WHATSAPP_MESSAGE, GET_MOBILE_APP, INSTALL_MOBILE_APP, USE_MOBILE_APP, INSTALL_APP, USE_APP, PLAY_GAME, TRY_DEMO, WATCH_VIDEO, WATCH_MORE, OPEN_LINK, NO_BUTTON, LISTEN_MUSIC, MOBILE_DOWNLOAD, GET_OFFER, GET_OFFER_VIEW, BUY_NOW, BUY_TICKETS, UPDATE_APP, BET_NOW, ADD_TO_CART, SELL_NOW, GET_SHOWTIMES, LISTEN_NOW, GET_EVENT_TICKETS, REMIND_ME, SEARCH_MORE, PRE_REGISTER, SWIPE_UP_PRODUCT, SWIPE_UP_SHOP, PLAY_GAME_ON_FACEBOOK, VISIT_WORLD, OPEN_INSTANT_APP, JOIN_GROUP, GET_PROMOTIONS, SEND_UPDATES, INQUIRE_NOW, VISIT_PROFILE, CHAT_ON_WHATSAPP, EXPLORE_MORE, CONFIRM, JOIN_CHANNEL, MAKE_AN_APPOINTMENT, ASK_ABOUT_SERVICES, BOOK_A_CONSULTATION, GET_A_QUOTE, BUY_VIA_MESSAGE, ASK_FOR_MORE_INFO, VIEW_PRODUCT, VIEW_CHANNEL, WATCH_LIVE_VIDEO, JOIN_LIVE_VIDEO, IMAGINE, CALL, MISSED_CALL, CALL_NOW, CALL_ME, APPLY_NOW, BUY, GET_QUOTE, SUBSCRIBE, RECORD_NOW, VOTE_NOW, GIVE_FREE_RIDES, REGISTER_NOW, OPEN_MESSENGER_EXT, EVENT_RSVP, CIVIC_ACTION, SEND_INVITES, REFER_FRIENDS, REQUEST_TIME, SEE_MENU, SEARCH, TRY_IT, TRY_ON, LINK_CARD, DIAL_CODE, FIND_YOUR_GROUPS, START_ORDER} The type of the action. Not all types can be used for all ads. Check Ads Product Guide to see which type can be used for based on the objective of your campaign. required value Object Default value: Vec JSON containing the call to action data. supports emoji --- android_url string ios_url string link URL app_link string page numeric string or integer link_format enum {VIDEO_LEAD, VIDEO_LPP, VIDEO_NEKO, VIDEO_NON_LINK, VIDEO_SHOP, WHATSAPP_CATALOG_ATTACHMENT} application numeric string or integer link_title string supports emoji link_description string supports emoji link_caption string product_link string get_movie_showtimes boolean sponsorship Object --- link URL image URL Show child parameters video_annotation Object --- annotations list<Object> --- start_time_in_sec int64 end_time_in_sec int64 link URL link_title string link_description string link_caption string image_url URL Show child parameters header_color string logo_url URL post_click_cta_title string post_click_description_title string Show child parameters offer_id numeric string or integer offer_view_id numeric string or integer advanced_data Object --- offer_id numeric string or integer Show child parameters lead_gen_form_id numeric string or integer referral_id numeric string or integer search_dialog_id numeric string or integer fundraiser_campaign_id numeric string or integer event_id numeric string or integer event_tour_id numeric string or integer app_destination enum {MESSENGER, MESSENGER_EXTENSIONS, MESSENGER_GAMES, LINK_CARD, MARKETPLACE, WHATSAPP, INSTAGRAM_DIRECT, INSTAGRAM_LIVE_VIDEO, FACEBOOK_LIVE_VIDEO} app_destination_page_id numeric string or integer is_canvas_video_transition_enabled boolean whatsapp_number string preinput_text string customized_message_page_cta_text string external_offer_provider_id numeric string or integer origins enum {COMPOSER, CAMERA} object_store_urls array<string> facebook_login_spec Object --- facebook_login_app_id numeric string or integer offer_type enum {NO_OFFER, PERCENTAGE_BASED, AMOUNT_BASED} offer_pct_call_to_action enum {TEN} offer_amt_call_to_action enum {TEN} Show child parameters product_id numeric string or integer group_id numeric string or integer channel_id string land_on_whatsapp_catalog enum{1, 2} land_on_whatsapp_profile string Show child parameters Show child parameters |
categorization_criteria enum{brand, category, product_type} | The Dynamic Category Ad's categorization criteria |
category_media_source enum{CATEGORY, MIXED, PRODUCTS_COLLAGE, PRODUCTS_SLIDESHOW} | The Dynamic Ad's rendering mode for category ads |
contextual_multi_ads JSON object | contextual_multi_ads --- eligibility array<enum {}> eligibility enroll_status enum {OPT_IN, OPT_OUT} enroll_status action_metadata JSON object action_metadata --- type enum {DEFAULT, DEFAULT_OPT_IN, DEFAULT_OPT_OUT, DUPLICATION_UPGRADE, DUPLICATION_UPSELL, MANUAL, STICKY_OPT_IN, STICKY_OPT_OUT} type required Show child parameters Show child parameters |
degrees_of_freedom_spec JSON object | Specifies the type of transformation which is enabled for the given creative --- ad_handle_type enum{ORIGINAL, DYNAMIC} degrees_of_freedom_type enum{DISABLED, USER_ENROLLED_AUTOFLOW, USER_ENROLLED_LWI_ACO, USER_ENROLLED_NON_DCO, USER_ENROLLED_IMAGE_CROPPING_NON_DCO, USER_ENROLLED, VIDEO_TEMPLATES, FAM_TOGGLE_ON, FAM_TOGGLE_OFF, SMART_CROP_ELIGIBLE_ON, SMART_CROP_ELIGIBLE_OFF, SMART_CROP_INELIGIBLE_ON, SMART_CROP_INELIGIBLE_OFF, VCK_MIXED_FORMAT} required multi_media_transformation_type enum{ADSET_IMAGES_TO_VIDEO, CAROUSEL_IMAGES_TO_VIDEO} mobile_app_star_rating_enabled boolean Default value: false image_transformation_types list<enum{CROPPING, ENHANCEMENT, COLOR_FILTERING, AUTOGEN_MIXED_FORMAT, FB_REELS_IMAGE_DEFAULT, IG_REELS_IMAGE_PORTAL}> text_transformation_types list<enum{TEXT_LIQUIDITY}> video_transformation_types list<enum{CROPPING, CROPPING_ACF, FB_REELS_VIDEO_DEFAULT, IG_REELS_VIDEO_PORTAL}> stories_transformation_types list<enum{SMART_CROP, INSTAGRAM_PROFILE_CARD, INSTAGRAM_END_CARD, INSTAGRAM_MOBILE_APP_INSTALL_CARD, PORTAL}> creative_features_spec JSON object {enum {IG_VIDEO_NATIVE_SUBTITLE, IMAGE_ANIMATION, PRODUCT_BROWSING, PRODUCT_METADATA_AUTOMATION, PROFILE_CARD, STANDARD_ENHANCEMENTS_CATALOG, TEXT_OVERLAY_TRANSLATION} : JSON object} Show child parameters |
destination_set_id numeric string | The ID of the Product Set for a Destination Catalog that will be used to link with Travel Catalogs. |
dynamic_ad_voice enum{DYNAMIC, STORY_OWNER} | Determines the Page voice to be used in Dynamic Local Ads |
enable_direct_install boolean | Whether Direct Install should be enabled on supported devices. |
enable_launch_instant_app boolean | Whether Instant App should be enabled on supported devices. |
execution_options list<enum{validate_only}> | Default value: Set An execution setting validate_only: when this option is specified, the API call will not perform the mutation but will run through the validation rules against values of each field. If the call passes validation or review, response will be {"success": true}. If the call does not pass, an error will be returned with more details. These options can be used to improve any UI to display errors to the user much sooner, e.g. as soon as a new value is typed into any field corresponding to this ad object, rather than at the upload/save stage, or after review. |
existing_post_title string | existing_post_title |
facebook_branded_content JSON object | Params required for facebook branded content. --- sponsor_page_id numeric string sponsor_page_id shared_to_sponsor_status enum {NOT_SHARED, ALL_SHARED} shared_to_sponsor_status Show child parameters |
format_transformation_spec array<JSON object> | format_transformation_spec --- data_source array<enum {APP_INFORMATION, CATALOG, IG_VALIDATION_BYPASS, MANUAL_UPLOADS, NONE, RELATED_MEDIA, SITE_LINKS}> Default value: [] data_source format enum {CAROUSEL, COLLAGE, DA_COLLECTION, SA_CAROUSEL, SA_COLLECTION, SINGLE_MEDIA, VIDEO_SLIDESHOW} format required customizations array<JSON object> customizations --- name enum {PRESERVE_HERO_MEDIA} name required enroll_status enum {OPT_IN, OPT_OUT} enroll_status required scope array<enum {APP_INFORMATION, CATALOG, IG_VALIDATION_BYPASS, MANUAL_UPLOADS, NONE, RELATED_MEDIA, SITE_LINKS}> Default value: [] scope Show child parameters Show child parameters |
image_crops dictionary { enum{191x100, 100x72, 400x150, 600x360, 100x100, 400x500, 90x160, 300x400} : <list<list<int64>>> } | Crop dimensions for the image specified. See image crop reference for more details. |
image_file string | Reference to a local image file to upload for use in a creative. Not to exceed 8MB in size. If object_story_spec or object_story_id is specified, this field will be ignored |
image_hash string | Image hash for an image you have uploaded and can be used in a creative. If object_story_spec or object_story_id is specified, this field will be ignored |
image_url URL | URL for the image in this ad creative. Do not use image URLs returned by Facebook. Instead you should host the image on your own servers. Facebook saves the image from your URL to your ad account's image library. Images cannot exceed 8 MB. You must also provide one of these three fields: image_file, image_hash, or image_url. |
instagram_branded_content JSON object | Params required for instagram branded content. --- sponsor_id numeric string or integer sponsor_asset_id numeric string or integer Show child parameters |
instagram_permalink_url URL | URL for a post on Instagram you want to run as an ad. Also known as Instagram media. |
instagram_user_id numeric string or integer | Instagram user ID |
interactive_components_spec JSON object | The specification for interactive component overlay on the media. supports emoji --- child_attachments list<JSON object> --- components list<JSON object> --- poll_spec JSON object required supports emoji --- option_a_text string required option_b_text string required question_text string Default value: "" Show child parameters product_tag_spec JSON object position_spec JSON object link_spec JSON object feed_media_spec JSON object product_sticker_spec JSON object cta_sticker_spec JSON object type enum {7, 14, 9, 4, 8, 5, 3, 12, 1, 11, 10, 2} required enroll_status enum {OPT_IN, OPT_OUT} Show child parameters Show child parameters components list<JSON object> --- poll_spec JSON object required supports emoji --- option_a_text string required option_b_text string required question_text string Default value: "" Show child parameters product_tag_spec JSON object position_spec JSON object link_spec JSON object feed_media_spec JSON object product_sticker_spec JSON object cta_sticker_spec JSON object type enum {7, 14, 9, 4, 8, 5, 3, 12, 1, 11, 10, 2} required enroll_status enum {OPT_IN, OPT_OUT} Show child parameters Show child parameters |
link_og_id string | The Open Graph (OG) ID for the link in this creative if the landing page has OG tags. |
link_url URL | Identify a specific landing tab on your Facebook page by the Page tab's URL. See connection objects for retrieving Page tab URLs. You can add app_data parameters to the URL to pass data to a Page's tab. |
marketing_message_structured_spec JSON object | marketing_message_structured_spec --- whats_app_business_phone_number_id string whats_app_business_phone_number_id is_optimized_text boolean is_optimized_text automation_config JSON object automation_config --- config_id numeric string config_id Show child parameters asset_customization JSON object asset_customization --- body string body Show child parameters conversation_template_id string conversation_template_id params_default_values JSON object params_default_values --- header_text array<JSON object> Default value: [] header_text --- param string param required default_value string default_value required Show child parameters body array<JSON object> Default value: [] body --- param string param required default_value string default_value required Show child parameters buttons array<JSON object> Default value: [] buttons --- index int64 index required param string param required default_value string default_value required Show child parameters Show child parameters template_name string template_name creative_sync_source enum {MM_CAMPAIGN_1P_SYNC, MMLITE_CREATIVE_SYNC} creative_sync_source Show child parameters |
media_sourcing_spec JSON object | media sourcing spec for advertiser to specify additional media from various sources --- related_media JSON object related_media --- images array<JSON object> images --- hash string hash url string url image_crops JSON object {string : array<array<int64>>} image_crops source enum {CATALOG_PRODUCTS, DCO, GEN_AI, MANUAL, MULTI_MEDIA, PUSH_MODEL, RELATED_MEDIA, REPLACE_MEDIA_TEXT} source group_id string group_id text_customizations JSON object text_customizations --- titles array<JSON object> titles --- text string text Show child parameters bodies array<JSON object> bodies --- text string text Show child parameters descriptions array<JSON object> descriptions --- text string text Show child parameters Show child parameters destination_customizations array<JSON object> destination_customizations --- url string url required display_url string display_url Show child parameters opt_in_status enum {OPT_IN, OPT_IN_AS_INFERRED_DA_INTRO_CARD, OPT_OUT} opt_in_status action_metadata enum {AI_AGENT, AMA, AUTORULE, CIC_GUIDANCE, CROP_OVERRIDE, DEFAULT, DEFAULT_FOR_PRODUCT_SET, DEFAULT_OFF, DUPLICATION_UPGRADE, MANUAL, PFR_GUIDANCE, PRODUCT_TAG_GUIDED, RECOMMENDATION_COLUMN_GUIDANCE, REFRESH, STICKY, SYD_GUIDANCE, UNKOWN} action_metadata creation_source enum {ADVERTISER_UPLOAD, WEBSITE_MEDIA, VIDEO_THUMBNAIL, OTHER} creation_source retriever_sources array<enum {AD_CONTEXT, ADS_LLAMA, CREATIVE_GRAPH, PIGGYBACK, SAME_ACCOUNT_MEDIA_SEARCH, VIDEO_THUMBNAIL, WEBSITE_MEDIA}> retriever_sources Show child parameters videos array<JSON object> videos --- video_id string video_id source enum {CATALOG_PRODUCTS, DCO, GEN_AI, MANUAL, MULTI_MEDIA, PUSH_MODEL, RELATED_MEDIA, REPLACE_MEDIA_TEXT} source group_id string group_id text_customizations JSON object text_customizations --- titles array<JSON object> titles --- text string text Show child parameters bodies array<JSON object> bodies --- text string text Show child parameters descriptions array<JSON object> descriptions --- text string text Show child parameters Show child parameters destination_customizations array<JSON object> destination_customizations --- url string url required display_url string display_url Show child parameters original_video_id string original_video_id opt_in_status enum {OPT_IN, OPT_IN_AS_INFERRED_DA_INTRO_CARD, OPT_OUT} opt_in_status action_metadata enum {AI_AGENT, AMA, AUTORULE, CIC_GUIDANCE, CROP_OVERRIDE, DEFAULT, DEFAULT_FOR_PRODUCT_SET, DEFAULT_OFF, DUPLICATION_UPGRADE, MANUAL, PFR_GUIDANCE, PRODUCT_TAG_GUIDED, RECOMMENDATION_COLUMN_GUIDANCE, REFRESH, STICKY, SYD_GUIDANCE, UNKOWN} action_metadata creation_source enum {ADVERTISER_UPLOAD, WEBSITE_MEDIA, VIDEO_THUMBNAIL, OTHER} creation_source retriever_sources array<enum {AD_CONTEXT, ADS_LLAMA, CREATIVE_GRAPH, PIGGYBACK, SAME_ACCOUNT_MEDIA_SEARCH, VIDEO_THUMBNAIL, WEBSITE_MEDIA}> retriever_sources Show child parameters Show child parameters titles array<JSON object> titles --- text string text Show child parameters bodies array<JSON object> bodies --- text string text Show child parameters descriptions array<JSON object> descriptions --- text string text Show child parameters images array<JSON object> images --- hash string hash url string url source enum {CATALOG_PRODUCTS, DCO, GEN_AI, MANUAL, MULTI_MEDIA, PUSH_MODEL, RELATED_MEDIA, REPLACE_MEDIA_TEXT} source image_crops array<JSON object> image_crops --- type enum {AUTO_CROP, MANUAL, SMART_CROP, SUPER_CROP} type required crop_spec JSON object {string : array<array<int64>>} crop_spec required Show child parameters destination_customizations array<JSON object> destination_customizations --- url string url required display_url string display_url Show child parameters placement_customizations array<JSON object> placement_customizations --- publisher_platform enum {FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS} publisher_platform required placement_exclusions array<string> placement_exclusions Show child parameters text_customizations JSON object text_customizations --- titles array<JSON object> titles --- text string text Show child parameters bodies array<JSON object> bodies --- text string text Show child parameters descriptions array<JSON object> descriptions --- text string text Show child parameters Show child parameters group_id string group_id opt_in_status enum {OPT_IN, OPT_IN_AS_INFERRED_DA_INTRO_CARD, OPT_OUT} opt_in_status creation_source enum {ADVERTISER_UPLOAD, WEBSITE_MEDIA, VIDEO_THUMBNAIL, OTHER} creation_source retriever_sources array<enum {AD_CONTEXT, ADS_LLAMA, CREATIVE_GRAPH, PIGGYBACK, SAME_ACCOUNT_MEDIA_SEARCH, VIDEO_THUMBNAIL, WEBSITE_MEDIA}> retriever_sources gen_ai_metadata JSON object gen_ai_metadata --- model_name string model_name user_action string user_action adoption_entrypoint string adoption_entrypoint Show child parameters Show child parameters videos array<JSON object> videos --- video_id string video_id required source enum {CATALOG_PRODUCTS, DCO, GEN_AI, MANUAL, MULTI_MEDIA, PUSH_MODEL, RELATED_MEDIA, REPLACE_MEDIA_TEXT} source placement_customizations array<JSON object> placement_customizations --- publisher_platform enum {FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, WHATSAPP, OCULUS, THREADS} publisher_platform required placement_exclusions array<string> placement_exclusions Show child parameters text_customizations JSON object text_customizations --- titles array<JSON object> titles --- text string text Show child parameters bodies array<JSON object> bodies --- text string text Show child parameters descriptions array<JSON object> descriptions --- text string text Show child parameters Show child parameters destination_customizations array<JSON object> destination_customizations --- url string url required display_url string display_url Show child parameters thumbnail_id string thumbnail_id thumbnail_url string thumbnail_url thumbnail_source enum {ASSUMED_CUSTOM, ASSUMED_GENERATED_DEFAULT, CUSTOM, GENERATED_DEFAULT, GENERATED_SELECTED, SCRUBBER_SELECTED, SHARPNESS_ENTROPY_SMART_SELECTED, SMART_SELECTED, THUMBNAIL_TESTING, UNKNOWN} thumbnail_source original_video_id string original_video_id opt_in_status enum {OPT_IN, OPT_IN_AS_INFERRED_DA_INTRO_CARD, OPT_OUT} opt_in_status creation_source enum {ADVERTISER_UPLOAD, WEBSITE_MEDIA, VIDEO_THUMBNAIL, OTHER} creation_source retriever_sources array<enum {AD_CONTEXT, ADS_LLAMA, CREATIVE_GRAPH, PIGGYBACK, SAME_ACCOUNT_MEDIA_SEARCH, VIDEO_THUMBNAIL, WEBSITE_MEDIA}> retriever_sources Show child parameters push_metadata_ids array<int64> push_metadata_ids Show child parameters |
name string | Name of this ad creative as seen in the ad account's library. |
object_id int64 | The Facebook object ID that is relevant to the ad. See connection objects |
object_story_id post_id | ID of a Facebook Page post to use in an ad. You can get this ID by querying the posts of the page. If this post includes an image, it should not exceed 8 MB. Facebook will upload the image from the post to your ad account's image library. |
object_story_spec string (ObjectStorySpec) | JSON string of AdCreativeObjectStorySpec type. Use if you want to create a new unpublished page post and turn the post into an ad. The Page ID and the content to create a new unpublished page post. Specify link_data, photo_data, video_data, text_data or template_data with the content. supports emoji |
object_type string | The type of Facebook object you want to advertise. Allowed values are: PAGE DOMAIN EVENT STORE_ITEM: refers to an iTunes or Google Play store destination OFFER SHARE: from a page PHOTO STATUS: of a page VIDEO APPLICATION: app on Facebook |
object_url URL | URL that opens if someone clicks your link on a link ad. This URL is not connected to a Facebook page. |
page_welcome_message string | You can create more tailored user experiences for your ads that click to Messenger or to WhatsApp by customizing your ads' greeting message. For ads that clicks to Whatsapp, you can set the the page_welcome_message field under object_story_spec. Note: If you are using the message received in Whatsapp to trigger any bot flows, please make sure to work with your BSP and agencies to update it so as to ensure flows aren't disrupted. supports emoji |
place_page_set_id numeric string | The Place Page Set when objective is LOCAL_AWARENESS. Used with Dynamic Local Ads |
platform_customizations JSON or object-like arrays | Use this field to specify the exact media to use on different Facebook placements. You can currently use this setting for images and videos. Facebook replaces the media originally defined in ad creative with this media when the ad displays in a specific placements. For example, if you define a media here for instagram, Facebook uses that media instead of the media defined in the ad creative when the ad appears on Instagram. --- instagram JSON or object-like arrays Specify the media to display in an Instagram ad. This displays instead of the media defined in the ad creative. --- image_url URL The URL of the image used for the platform specific media. Either this field or image_hash is required. image_hash string The ad image used for the platform specific media. Either this field or image_url is required. image_crops dictionary { enum{191x100, 100x72, 400x150, 600x360, 100x100, 400x500, 90x160, 300x400} : <list<list<int64>>> } A JSON object defining crop dimensions for the image specified. See Image Crops for more details. Show child parameters Show child parameters |
playable_asset_id numeric string | The ID of the playable asset in this creative. |
portrait_customizations JSON object | Use this field to customizations how ads look in portrait mode format example for IG Stories, Facebook Stories, IGTV, etc --- specifications array<JSON object> specifications --- background_color JSON object background_color required --- bottom_color string bottom_color required top_color string top_color required Show child parameters Show child parameters carousel_delivery_mode enum {fixed_num_cards, optimal_num_cards} carousel_delivery_mode Show child parameters |
product_set_id numeric string or integer | Used for Dynamic Ad. An ID for a product set, which groups related products or other items being advertised. |
recommender_settings JSON object | The recommender settings that can be used to control recommendations for Dynamic Ads. --- preferred_events list<enum{ViewContent, Search, AddToCart, AddToWishlist, InitiateCheckout, AddPaymentInfo, Purchase, Subscribe, RecurringSubscriptionPayment, Lead, CompleteRegistration, CustomConversion, AggregateCustomConversion, Other}> product_sales_channel enum {ONLINE, IN_STORE, OMNI} Show child parameters |
referral_id numeric string or integer | The ID of Referral Ad Configuration in this creative. |
regional_regulation_disclaimer_spec JSON object | regional_regulation_disclaimer_spec --- taiwan_finserv JSON object taiwan_finserv --- taiwan_finserv_funder_id numeric string taiwan_finserv_funder_id required Show child parameters australia_finserv JSON object australia_finserv --- australia_finserv_beneficiary_id numeric string australia_finserv_beneficiary_id required australia_finserv_payer_id numeric string australia_finserv_payer_id required Show child parameters taiwan_universal JSON object taiwan_universal --- taiwan_universal_beneficiary_id numeric string taiwan_universal_beneficiary_id required taiwan_universal_payer_id numeric string taiwan_universal_payer_id required Show child parameters india_finserv JSON object india_finserv --- india_finserv_beneficiary_id numeric string india_finserv_beneficiary_id required india_finserv_payer_id numeric string india_finserv_payer_id required Show child parameters singapore_universal JSON object singapore_universal --- singapore_universal_beneficiary_id numeric string singapore_universal_beneficiary_id required singapore_universal_payer_id numeric string singapore_universal_payer_id required Show child parameters Show child parameters |
source_instagram_media_id numeric string or integer | The ID of an Instagram post to use in an ad |
template_url URL | The product link url, which overrides the one set in Dynamic Product Ad's product feeds. |
template_url_spec string (TemplateURLSpec) | An optional structured collection of templated web and app-link descriptors that override the fallbacks that would otherwise be pulled from a Dynamic Ad's catalog --- android Object --- app_name string package string url string Show child parameters ios Object --- app_name string app_store_id string url string Show child parameters ipad Object --- app_name string app_store_id string url string Show child parameters iphone Object --- app_name string app_store_id string url string Show child parameters windows_phone Object --- app_name string app_id string url string Show child parameters web Object --- url URL should_fallback string Show child parameters config Object --- app_id string third_party_app_id string enable_third_party_deeplink boolean third_party_dso_ids list<string> Show child parameters Show child parameters |
threads_user_id numeric string or integer | threads_user_id |
thumbnail_url URL | URL for a thumbnail image for this ad creative. You can provide dimensions for this with thumbnail_width and thumbnail_height. See example. |
title string | Title for a Page Likes ad, which appears in the right-hand column on Facebook. |
url_tags string | A set of query string parameters which will replace or be appended to urls clicked from page post ads, message of the post, and canvas app install creatives only. |
use_page_actor_override boolean | If true, we show the page actor for mobile app ads. |
wamo_whatsapp_identity_spec JSON object | wamo_whatsapp_identity_spec --- wamo_whatsapp_identity_id numeric string wamo_whatsapp_identity_id whatsapp_phone_number string whatsapp_phone_number Show child parameters |
Return Type
This endpoint supports read-after-write and will read the node represented by id in the return type.
Struct {
id: numeric string,
success: bool,
}Error Codes
| Error Code | Description |
|---|---|
| 100 | Invalid parameter |
| 500 | Message contains banned content |
| 200 | Permissions error |
| 2635 | You are calling a deprecated version of the Ads API. Please update to the latest version. |
| 613 | Calls to this api have exceeded the rate limit. |
| 1500 | The url you supplied is invalid |
| 80004 | There have been too many calls to this ad-account. Wait a bit and try again. For more info, please refer to /docs/graph-api/overview/rate-limiting#ads-management. |
| 105 | The number of parameters exceeded the maximum for this operation |
| 368 | The action attempted has been deemed abusive or is otherwise disallowed |
| 190 | Invalid OAuth 2.0 Access Token |
Updating
You can't perform this operation on this endpoint.
Deleting
You can't perform this operation on this endpoint.