Threads Cross-Share to Instagram Stories

Share Threads posts to the linked Instagram account's Story.

Share a Threads post to the Story of its linked Instagram account. Publer sends the cross-share request with the Threads post.

Cross-share is set per Threads account in that account's share object. It needs no Instagram account entry or separate endpoint.

Overview

A cross-share failure never blocks the Threads post. Publer reports the failure in share.crossshare.

How it works

1. Add share.crossshare to a Threads entry in accounts.
2. Publish or schedule the Threads post.
3. Read the result from share.crossshare.status on the returned post.

Set cross-share while creating the post. PUT /api/v1/posts/{id} does not change it.

Cross-share parameters

Add cross-share at bulk.posts[].accounts[].share.crossshare. Do not add it under networks.

Parameter	Type	Required	Default	Description
share	object	Yes	—	The account auto-share object.
share.crossshare	object	Yes	—	Cross-share settings. Only enabled and dark_mode are read.
share.crossshare.enabled	boolean	Yes	false	true shares the Threads post to the linked Instagram Story.
share.crossshare.dark_mode	boolean	No	false	Displays the Story card in dark mode. Requires enabled: true.
share.account_ids	array	No	[]	Accounts to auto-share to. Omit or leave empty for cross-share only.
share.text, share.delay	—	No	—	Auto-share settings. They do not affect the Instagram Story.

Send booleans as true or false. The strings "true" and "false" also work.

status and error are read-only. Publer ignores those fields in create requests.

enabled	dark_mode	Result
true	Omitted or false	Story is shared in light mode.
true	true	Story is shared in dark mode.
Omitted or false	true	No cross-share. dark_mode is ignored.
Omitted or false	Omitted or false	No cross-share.

Supported Threads post types

Set the type with networks.threads.type.

Type	Cross-share	Notes
status	Yes	Text-only post.
photo with 1 image	Yes
photo with 2–20 images	Yes	Published as a carousel. The complete carousel is cross-shared.
gif	Yes	Published as an image.
video	Yes
link with a website URL	Yes	Published with a link attachment.
link with a Threads URL, text, or follow-up comment	Yes	Published as a quote post.
link with a Threads URL only	No	Published as a repost. Threads does not accept cross-share for reposts.

Examples

Schedule a text post

This post cross-shares only. It does not auto-share to another account.

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "threads": {
            "type": "status",
            "text": "Big news dropping this Friday. Stay tuned!"
          }
        },
        "accounts": [
          {
            "id": "threads_account_123",
            "scheduled_at": "2026-10-02T14:00:00Z",
            "share": {
              "crossshare": {
                "enabled": true
              }
            }
          }
        ]
      }
    ]
  }
}

Publish a photo in dark mode

Send this payload to POST /api/v1/posts/schedule/publish.

{
  "bulk": {
    "posts": [
      {
        "networks": {
          "threads": {
            "type": "photo",
            "text": "Our new office is finally ready.",
            "media": [
              {
                "id": "media_photo_001",
                "path": "https://storage.com/office.jpg"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "threads_account_123",
            "share": {
              "crossshare": {
                "enabled": true,
                "dark_mode": true
              }
            }
          }
        ]
      }
    ]
  }
}

Cross-share and auto-share

This post cross-shares immediately. It also auto-shares to Facebook after 10 minutes.

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "threads": {
            "type": "video",
            "text": "Behind the scenes of our latest shoot 🎬",
            "media": [
              {
                "id": "media_video_001",
                "path": "https://storage.com/bts.mp4"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "threads_account_123",
            "scheduled_at": "2026-10-02T16:00:00Z",
            "share": {
              "account_ids": ["facebook_page_456"],
              "text": "In case you missed it on Threads 👇",
              "delay": { "duration": 10, "unit": "Minute" },
              "crossshare": {
                "enabled": true,
                "dark_mode": false
              }
            }
          }
        ]
      }
    ]
  }
}

Read the result

GET /api/v1/posts/{id} and GET /api/v1/posts return cross-share under share.crossshare.

Field	Type	Description
enabled	boolean	The value sent in the request.
dark_mode	boolean	The value sent in the request.
status	string	published or failed. It is absent until publication and in some outcomes.
error	string	Present only when status is failed. It is localized and ready to display.

status	Meaning
Missing	The post has not published, Threads returned no result, or the post was a repost. Do not treat this as a failure.
published	Threads confirmed the Story was shared.
failed	The Story was not shared. The Threads post still published. Inspect error.

Response examples

Shared successfully

"share": {
  "account_ids": [],
  "crossshare": {
    "enabled": true,
    "dark_mode": true,
    "status": "published"
  }
}

Cross-share failed

"share": {
  "account_ids": [],
  "crossshare": {
    "enabled": true,
    "dark_mode": false,
    "status": "failed",
    "error": "Couldn't share this post to your Instagram Story. Make sure your Threads profile has a linked Instagram account."
  }
}

Permission missing

"share": {
  "account_ids": [],
  "crossshare": {
    "enabled": true,
    "dark_mode": false,
    "status": "failed",
    "error": "Sharing to Instagram Stories requires additional permissions. Please reauthorize your Threads account to enable it."
  }
}

A pending post, a repost, or a post without a Threads result has no status.

Tips & limitations

Case	Threads post	Cross-share result
Post has not published	Not published	No status.
Threads confirms the Story	Published	status: "published".
Threads reports a Story failure	Published	status: "failed" and an error.
Threads rejects cross-share	Published after Publer resends without cross-share	status: "failed" and an error.
Threads rejects cross-share for missing permission	Published after Publer resends without cross-share	status: "failed" and a reauthorization error.
Threads returns no result	Published	No status.
Post is a repost	Published	No status.
Threads post fails	Failed with its usual error	No status.
crossshare is set on a non-Threads account	—	Removed without an error. Other share values remain.

Cross-share requires the auto-share feature in your plan. Without it, the post is not created and returns: Please upgrade your plan to continue scheduling follow-up comments, auto-shares, and autodeletes.

• Cross-share works only for Threads accounts.
• The Threads profile needs a linked Instagram account. You cannot choose another Instagram account.
• Set share.crossshare on each eligible Threads account in a multi-account post.
• Removing share disables cross-share.
• An already-published post cannot be cross-shared.

Related topics

• Accounts

• Content Types

• Creating Posts