Threads

Connect your Threads account to schedule and publish posts through Cue.

Overview

Threads is a text-based conversation platform from Instagram. Cue integrates with the Threads API to publish content on your behalf.

Important: Threads requires an Instagram Business or Creator account. Your Threads account is automatically linked to your Instagram account.

Sign up for Threads at threads.net.

Authentication

Threads uses OAuth 2.0 via Instagram for secure authentication. You must have an Instagram Business or Creator account connected to your Threads profile.

Prerequisites

Before connecting to Cue:

1. Download the Threads app and create an account using your Instagram login
2. Ensure your Instagram account is a Business or Creator account
3. Your Instagram account must be connected to a Facebook Page

Connecting Your Account

1. Go to Profiles in your Cue dashboard
2. Click Connect Account on a profile
3. Select Threads
4. You'll be redirected to Instagram/Facebook to authorize access
5. Grant Cue permission to post on your behalf
6. You'll be redirected back to Cue automatically

Your credentials are never shared with Cue.

Disconnecting

To disconnect your Threads account, go to your profile and click Disconnect next to the Threads connection. This revokes Cue's access to your account.

You can also revoke access from your Instagram settings under Apps and websites.

Content Limits

Threads enforces the following limits on posts:

Cue automatically validates your content length before publishing to prevent errors.

Publishing a Post

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_threads1": {
        "items": [{ "content": "Sharing my thoughts on Threads!" }]
      }
    },
    "publishNow": true
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_threads1: {
        items: [{ content: "Sharing my thoughts on Threads!" }]
      }
    },
    publishNow: true,
  }),
});

Schedule for Later

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_threads1": {
        "items": [{ "content": "Scheduled Threads post" }]
      }
    },
    "scheduledAt": "2024-01-20T09:00:00-05:00"
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_threads1: {
        items: [{ content: "Scheduled Threads post" }]
      }
    },
    scheduledAt: "2024-01-20T09:00:00-05:00",
  }),
});

Creating Threads

Create multi-post threads by including multiple items in the items array. Each item becomes a connected post in the thread.

curl -X POST https://api.oncue.so/v1/posts \
  -H "Authorization: Bearer cue_sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "prf_abc123",
    "platforms": {
      "sac_threads1": {
        "items": [
          { "content": "1/ Starting a thread on Threads..." },
          { "content": "2/ Text-based conversations are making a comeback..." },
          { "content": "3/ Short-form content sparks longer discussions..." },
          { "content": "4/ What do you think? Drop your thoughts below!" }
        ]
      }
    },
    "publishNow": true
  }'

const response = await fetch("https://api.oncue.so/v1/posts", {
  method: "POST",
  headers: {
    Authorization: "Bearer cue_sk_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "prf_abc123",
    platforms: {
      sac_threads1: {
        items: [
          { content: "1/ Starting a thread on Threads..." },
          { content: "2/ Text-based conversations are making a comeback..." },
          { content: "3/ Short-form content sparks longer discussions..." },
          { content: "4/ What do you think? Drop your thoughts below!" }
        ]
      }
    },
    publishNow: true,
  }),
});

Each post in a thread must respect the 500 character limit.

Response

{
  "data": {
    "id": "pst_xyz789",
    "profileId": "prf_abc123",
    "content": "Sharing my thoughts on Threads!",
    "status": "queued",
    "scheduledAt": null,
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  },
  "message": "Post queued for publishing to 1 platform(s)"
}

Error Handling

Threads API errors are translated into user-friendly messages:

Common Issues

"Reconnect required" error

• Your access token has expired or been revoked
• Go to your profile and reconnect your Threads account

"Content too long" error

• Your post exceeds 500 characters
• Shorten your message or split it into multiple posts

"Instagram Business account required" error

• Threads API requires an Instagram Business or Creator account
• Convert your Instagram account in settings

"Account not found" error

• Ensure you have created a Threads account
• Your Threads must be linked to your Instagram

Troubleshooting

Connection Issues

"No Threads account found"

• Create a Threads account using the Threads app
• Ensure your Instagram is a Business or Creator account
• Threads is automatically linked to your Instagram

Cannot redirect during OAuth

• Check your internet connection
• Try using a different browser
• Disable browser extensions that might block redirects

"Permission denied" during authorization

• Ensure you grant all requested permissions
• Verify your Instagram account type

Publishing Issues

Posts not appearing on Threads

• Check if your post is still in "queued" status
• Wait a few minutes - publishing may take time
• Check the post's platform status for error details

Links not previewing

• Threads may take time to generate link previews
• Only one link per post is allowed
• Some URLs may not generate previews

Mentions not working

• Use @username format for mentions
• The mentioned user must have a Threads account
• User must be public or follow you

Best Practices

Content Guidelines

• Keep posts conversational and engaging
• Use threads (multiple connected posts) for longer content
• Reply to other users to build community
• Be authentic - Threads favors genuine conversations

Timing

• Post when your audience is most active
• Threads engagement patterns differ from Instagram
• Experiment with different posting times

Cross-Platform Strategy

• Threads content can complement Instagram Stories
• Share different content types on each platform
• Use Threads for text-heavy updates

Further Reading

• Threads Help Center
• Instagram Business Account Help
• Threads API Documentation