Ads and Commerce
Ads and Commerce
Resources

Threads Carousel Ads

Updated: Sep 23, 2025
To create carousel ads, provide an ad creative with multiple child_attachments in link_data for threads_stream. You need to provide the threads_user_id and only use objectives supported in Threads ads.
There are some differences between Threads and Instagram carousel ads. These differences only happen with the Threads placement. If you have an ad set with Facebook, Instagram, and Threads placements enabled, what works on Facebook and/or Instagram may be different from that on Threads.
  • Each attachment must have a link specified, which is the destination of the image click.
  • There is no call to action button on the ad. If a headline or name is provided for an attachment, it will overwrite the call To action text. If no headline or name is provided, the call to action text will be used for the attachment.
  • Only 10 children are allowed for inline creation.

Image Cards

  • Each attachment must have either a picture or image_hash set. We do not default the image from link_data.
  • See the media requirements for supported image specifications.

Example request

curl -X POST \
  -F 'name=Threads Carousel Creative' \
  -F 'object_story_spec={
      "instagram_user_id": "<IG_USER_ID>",
      "threads_user_id": "<THREADS_USER_ID>",
      "page_id": "<PAGE_ID>",
      "link_data": {
        "child_attachments": [
          {
            "link": "<LINK_1>",
            "image_hash": "<IMAGE_HASH_1>",
            "description": "$8.99",
            "name": "Product 1"
          },
          {
            "link": "<LINK_2>",
            "image_hash": "<IMAGE_HASH_2>",
            "description": "$9.99",
            "name": "Product 2"
          },
          {
            "link": "<LINK_3>",
            "image_hash": "<IMAGE_HASH_3>",
            "call_to_action": {
              "type": "LEARN_MORE"
            }
          }
        ],
        "message": "<MESSAGE_TEXT>"
      }
    }
' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

Learn More

Did you find this page helpful?
Thumbs up icon
Thumbs down icon