Threads

Threads by Meta (Instagram's text-based social network) is fully supported in Outstand through the Bring Your Own Key (BYOK) model. This allows you to use your own Meta app credentials to connect Threads accounts without any Outstand branding during the connection process.

Note: You can skip the approval process by using our Managed Keys service. Contact our support team to learn more at contact@outstand.so. Turnaround time is typically 1 business day.

Quick Information

Our application works with the following OAuth scopes:

  • threads_basic - Basic Threads access
  • threads_content_publish - Permission to publish posts
  • threads_manage_insights - Access to insights for posts

No matter if you use our Managed Keys service or not, these are the scopes that are required for the integration to work.

Prerequisites

Before you begin, ensure you have:

  • A Meta (Facebook) Developer account
  • Access to Meta's developer portal at developers.facebook.com
  • At least one Instagram Business or Creator account for testing

Note: Threads posting is integrated through Meta's Instagram API, so you'll need an Instagram Business account to use Threads integration with Outstand.

Step 1: Create a Meta Developer Account

If you don't already have one:

  1. Go to developers.facebook.com
  2. Click Get Started or My Apps in the top right
  3. Sign in with your Facebook account
  4. Complete your developer profile by verifying your identity

Step 2: Create a New App

  1. Navigate to developers.facebook.com/apps
  2. Click Create App
  3. Select your app type:
    • Choose Business if you're managing social media for a business
    • Choose Consumer for personal use (some features may be limited)
  4. Fill in the required details:
    • App Display Name: Your application name (e.g., "My Social Media Manager")
    • App Contact Email: Your email address
    • Business Account: Select or create a Business Account (optional but recommended)

Step 3: Add Threads Product to Your App

  1. After creating your app, you'll see the Add Products to Your App page
  2. Find Threads in the list of available products
  3. Click Set Up next to Threads
  4. Accept the required permissions and terms

If you don't see Threads in the products list:

  • Ensure you have a Meta Business Account
  • Verify your app type supports Threads integration
  • Contact Meta support if Threads product is unavailable in your region

Step 4: Configure Basic Settings

  1. Navigate to Settings → Basic in your app dashboard

  2. Fill in the required fields:

    • App Name: Confirm or update your app name
    • App Domain: Your website domain
    • Privacy Policy URL: Link to your privacy policy
    • Terms of Service URL: Link to your terms of service
    • App Icon: Upload a 1024x1024px app icon (optional)

  3. Click Save Changes

Step 5: Configure OAuth Settings

  1. Scroll down to Basic Settings → Add Platform
  2. Select Website from the platform options
  3. Enter your Site URL (required for OAuth redirects)
  4. Add Valid OAuth Redirect URIs:
    • For production: https://www.outstand.so/app/api/socials/threads/callback

Step 6: Add Required Permissions

  1. Go to Products → Threads → Tools

  2. You'll need to request the following permissions:

    • threads_basic - Basic Threads access
    • threads_content_publish - Permission to publish posts
    • threads_manage_insights - Access to insights for posts

  3. Click on each permission to configure:

    • Read the description of each permission
    • Accept the required use cases
    • Provide explanations for how you'll use the permission

Important: Meta requires detailed explanations for certain permissions, especially publishing permissions. Be specific about your use case for social media management and scheduling.

Step 7: Submit for App Review (If Required)

For certain permissions (especially publishing), Meta requires app review:

  1. Go to App Review → Permissions and Features
  2. Click Request next to permissions marked with a yellow warning
  3. Provide detailed information:
    • How will you use this permission? Describe your social media management use case
    • Why do you need this permission? Explain the business need for posting
    • Instructions: Provide clear, step-by-step instructions for reviewers to test your app
  4. Submit a screencast showing your app's functionality (if required)

Processing Time: App review typically takes 1-7 business days. Meta may request additional information or clarifications.

Step 8: Obtain Your Credentials

  1. Navigate to Settings → Basic in your app dashboard

  2. You'll find two important values:

    • App ID: This is your OAuth Client ID (referred to as "client_key" in the API)
    • App Secret: This is your OAuth Client Secret (referred to as "client_secret" in the API)

  3. Click Show next to App Secret to reveal it

  4. Copy both values immediately and store them securely

Security Warning: Your App Secret is sensitive and should never be exposed. Copy it only once and store it securely.

Step 9: Add Credentials to Outstand

Once you have your App ID and App Secret, you can add them to Outstand:

Method 1: Using the Dashboard

  1. Log in to Outstand Dashboard
  2. Navigate to Settings → Social Networks
  3. Select Threads from the dropdown
  4. Enter your App ID in the "Client ID / API Key" field
  5. Enter your App Secret in the "Client Secret / API Secret" field
  6. Click Add Social Network

Method 2: Using the API

curl -X POST https://api.outstand.so/v1/social-networks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "threads",
    "client_key": "YOUR_APP_ID_HERE",
    "client_secret": "YOUR_APP_SECRET_HERE"
  }'

Step 10: Connect Your Threads Account

After adding your credentials:

  1. Ensure you have an Instagram Business or Creator account
  2. Navigate to Accounts in your Outstand dashboard
  3. Click Connect Account
  4. Select Threads
  5. Complete the Meta/Instagram authorization flow
  6. Grant the required permissions
  7. Your Threads account will appear in your connected accounts list

Note: Since Threads is integrated through Instagram, you'll need to connect an Instagram account that has Threads enabled.

Troubleshooting

"Invalid client credentials"

  • Verify you copied the App ID and App Secret correctly
  • Ensure there are no extra spaces or newlines in your credentials
  • Check that your app hasn't been deleted or disabled in Meta's system

"App not approved for this operation"

  • Some publishing operations require App Review approval from Meta
  • Verify that all required permissions have been approved
  • Check your app's status in the Meta Business Suite

"Redirect URI mismatch"

  • Verify the redirect URIs in your Meta app settings match exactly with Outstand's callback URL
  • Redirect URIs are case-sensitive and must include the full path

"Threads not available in my region"

  • Threads availability varies by region
  • Ensure your Instagram account has Threads access enabled
  • Check Meta's Threads availability documentation for your region

Important Notes

  • App Review: Publishing to Threads requires app review and approval from Meta. This process can take several days to weeks depending on your use case complexity.

  • Rate Limits: Meta's API has rate limits that vary by operation type. Threads posting typically has more restrictive limits than read operations.

  • Credential Security: Never share your App Secret or commit it to version control. Use secure credential management for production apps.

  • Test Mode vs Live Mode: You can test most features in Test Mode before completing App Review. However, publishing posts requires a live app with approved permissions.

Available Metrics

When using the Account Metrics API with a Threads account, the following engagement data is available:

MetricDescription
viewsTotal content views for the period
likesTotal likes received
commentsTotal replies received
repostsTotal reposts of content
quotesTotal quote posts

Requirements:

  • threads_manage_insights permission must be approved
  • Supports date range filtering via since and until parameters (Unix timestamps)

Next Steps

Once your Threads credentials are configured and approved, you can:

  1. Connect your Threads accounts via the Outstand dashboard
  2. Create Threads posts using the Posts API
  3. Schedule your Threads content for optimal timing
  4. Upload media for your Threads posts via the Media API

On this page

Quick InformationPrerequisitesStep 1: Create a Meta Developer AccountStep 2: Create a New AppStep 3: Add Threads Product to Your AppStep 4: Configure Basic SettingsStep 5: Configure OAuth SettingsStep 6: Add Required PermissionsStep 7: Submit for App Review (If Required)Step 8: Obtain Your CredentialsStep 9: Add Credentials to OutstandMethod 1: Using the DashboardMethod 2: Using the APIStep 10: Connect Your Threads AccountTroubleshooting"Invalid client credentials""App not approved for this operation""Redirect URI mismatch""Threads not available in my region"Important NotesAvailable MetricsNext Steps