Threads API setup

Create a Threads API key and long-lived token.

Threads publishing runs through a Meta developer app. For Oryginal, you need the Threads App ID, Threads App Secret, an OAuth redirect URL, the publishing scopes, a Threads user ID, and a long-lived Threads user access token.

Before you start

What you need from Meta

App values

  • A Meta developer app with Threads API access configured.
  • The Threads App ID from the app dashboard.
  • The Threads App Secret from the app settings.
  • An OAuth redirect URL added to the app allowlist.

Publishing values

  • The threads_basic permission for account identity.
  • The threads_content_publish permission for publishing.
  • The Threads user ID for the account Oryginal should publish as.
  • A long-lived user token generated from a fresh OAuth authorization code.

Threads short-lived tokens are exchanged for long-lived tokens. Long-lived tokens currently last 60 days and should be refreshed before they expire.

Meta app steps

Create the Threads app values

  1. Open Meta for Developers and create a new app, or select the app you will use for Oryginal.
  2. Add or configure Threads API access for the app.
  3. Copy the Threads App ID and Threads App Secret from the app dashboard.
  4. Add the exact redirect URL you will use in the helper, for example https://oryginal.nomadcompass.xyz/.
  5. Request or enable the Threads permissions required for the accounts you will authorize.
Generate token

Use the Oryginal Threads helper

  1. Open the Threads Token Helper.
  2. Paste the Threads App ID and Threads App Secret.
  3. Optionally paste the expected Threads user ID if you already know it.
  4. Generate the OAuth link and authorize the Threads account that should publish.
  5. Paste the returned code value or the full redirect URL into the helper.
  6. Let the helper exchange the code, convert the token to a long-lived token, and verify the account.

The authorization code can be used once. If the exchange fails with a reused or expired code, generate a new OAuth link and authorize again.

Oryginal fields

Where the final values go

Threads User ID

Paste the verified Threads user ID returned by the helper. This identifies the account Oryginal should publish from.

Threads Access Token

Paste the raw long-lived access token returned by the helper. Keep it paired with the same Threads user ID.

Official references

Meta Threads documentation used by this guide