Ads and Commerce
Ads and Commerce
Resources

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

GET /v25.0/act_<AD_ACCOUNT_ID>/adcreatives?fields=name HTTP/1.1
Host: graph.facebook.com
Try 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_id being 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 radius can cause an error, code: 100, subcode 1815946, when targeting multiple locations. We recommend creating an ad for each location or not using radius in your call.

Example

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%3E
Try 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, 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, 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, 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.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon