Appearance
Fresh 2026
Ad Creative Link Data Child Attachment
Reading
Data defining a child attachment associated with a link ad, used for Carousel ads.
Parameters
This endpoint doesn't have any parameters.
Fields
| Field | Description |
|---|---|
call_to_action<br>AdCreativeLinkDataCallToAction | Call to action of this attachment. On Facebook, we support<br>one optional CTA per attachment. If it not specified, there will<br>be no CTA for this attachment. <br>On Instagram, there is one CTA per attachment. If<br>the CTA is not specified, a CTA will be created by the system, using<br>"Learn more" as the type, and the link from this child attachment<br>as the link. If the CTA is specified, its link must be the same<br>as the link of this child attachment.<br>Default |
caption<br>string | The display url shown at the end of a video, if the attachment<br>is a video<br>Default |
caption_ids<br>list<numeric string> | The automated generated caption/SRT caption ids of the video. |
description<br>string | Overwrites the description of each attachment on Facebook, not used<br>on Instagram.<br>Default |
image_crops<br>AdsImageCrops | Image crops, using the crop spec with 100x100 key for Carousel ads.<br>If no 100x100 crop spec is provided, the image would be cropped<br>automatically, unless the image is square already. The final cropped<br>image size needs to be at least 200x200 pixels for Facebook, or<br>600x600 for Instagram.<br>Default |
image_hash<br>string | The image hash of an uploaded image for this attachment. For an ad<br>on Facebook, if<br>neither picture nor image_hash is set, the image of link_data<br>above will be used. For an ad on Instagram, either picture or<br>image_hash is required.<br>Default |
link<br>string | The link of this attachment.<br>Default |
name<br>string | Overwrites the title of the attachment on Facebook, not used on<br>Instagram.<br>Default |
picture<br>string | The url of an image for this attachment. For an ad on Facebook, if<br>neither picture nor image_hash is set, the image specified in<br>link_data above will be used. For an ad on Instagram, either picture<br>or image_hash is required.<br>Default |
referral_id<br>numeric string | If you are running Referral Ads in the carousel format, provide this ID. You can generate this ID in Graph Explorer or via the Marketing API at the {ad_account_id}/referral endpoint. Facebook uses this ID to attribute conversions back to a referred ad and to render the correct deep-link to the individual item being referred.<br>Default |
static_card<br>bool | Whether to force the card to render statically, even in a dynamic ad.<br>Default |
video_id<br>numeric string | ID of an uploaded video, if this attachment is a video. Not supported<br>for Instagram ads.<br>Default |
Creating
You can't perform this operation on this endpoint.
Updating
You can't perform this operation on this endpoint.
Deleting
You can't perform this operation on this endpoint.