Post to Threads automatically

01

Connect Threads

1. In the dashboard, open Accounts and pick Threads.
2. Sign in with Threads and allow Reelspan to post.
3. The account joins the profile you had open; every post to that profile can now include it.

Posting for clients? Send them a connect link so they connect their own Threads account without a Reelspan login.

02

Get an API key

In the dashboard, open Developers → API keys and create one. Keep it in an environment variable such as REELSPAN_KEY; never in code you share.

03

Post with one request

Send the video as a file, or as a public URL like below. Add more platform[] fields to post the same thing everywhere at once.

curl -X POST https://api.reelspan.com/v1/posts/video \
  -H "Authorization: Bearer $REELSPAN_KEY" \
  -F user=my-brand \
  -F "platform[]=threads" \
  -F "video=https://example.com/clip.mp4" \
  -F "title=Your post" \
  -F "threads_topic_tag=…"

const form = new FormData();
form.append('user', 'my-brand');
form.append('platform[]', 'threads');
form.append('video', 'https://example.com/clip.mp4');
form.append('title', 'Your post');

const res = await fetch('https://api.reelspan.com/v1/posts/video', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.REELSPAN_KEY}` },
  body: form,
});
console.log(await res.json());

import os, requests

res = requests.post(
    "https://api.reelspan.com/v1/posts/video",
    headers={"Authorization": f"Bearer {os.environ['REELSPAN_KEY']}"},
    files=[
        ("user", (None, "my-brand")),
        ("platform[]", (None, "threads")),
        ("video", (None, "https://example.com/clip.mp4")),
        ("title", (None, "Your post")),
    ],
)
print(res.json())

threads_title sets the text for Threads only, when it should differ from the other networks’.

04

Threads options

threads_title

The post text for Threads, up to 500 characters.

threads_topic_tag

The topic tag.

threads_reply_control

Who can reply.

threads_poll_options

A poll of 2 to 4 options.

threads_link_attachment

A link shown as a preview.

• Text, photo, video and mixed carousel posts.
• A first comment can follow the post as a reply.

Every field, with its limits: the docs.

05

Schedule it and check the result

• Add scheduled_date (ISO 8601) and timezone to post later, or add_to_queue=true to take the next slot of your posting schedule.
• The response has Threads’s status and the post’s link. For big files send async_upload=true and check GET /v1/posts/status?request_id=…, or get a signed webhook when it’s live.
• If Threads refuses a post, the error says why in plain words, and you can retry just that network.

06

Without code

• n8n, Make, Zapier or Airtable: the same request from a workflow.
• Claude, ChatGPT or any MCP client: ask “post this to Threads”.
• The dashboard: write once, check Threads’s limits as you type, post now or schedule.

07

Ideas

• Mirror X posts to Threads with one extra platform[] field.
• Mixed photo and video carousels.

More on Threads: what you can post there. Other networks: all upload guides.