Skip to content

Threads BYOK OAuth setup

Threads BYOK OAuth setup begins with the provider application. Create a Meta Threads app, add the Threads API product, and configure its callback, test users and permissions for a BYOK connection.

Callback URL

Register {{API_BASE_URL}}/v1/connect/threads/callback in the provider’s OAuth redirect settings. Configure the API origin for your environment and keep the callback path unchanged.

Configure Meta

  1. Create an app in Meta for Developers and add Threads API.
  2. Register the callback in the Threads OAuth redirect settings.
  3. Complete the app’s public details and add Threads test users.
  4. Request the listed permissions through App Review before production use.
  5. Copy the Meta app ID and app secret.

Permissions and access restrictions

Use the permission identifiers listed in the table. Use test users during development. Production permission approval remains a separate App Review step.

Save the app before connecting an account

Open Integrations → Apps (BYOK) → New app and select Threads. Fill the client ID and client secret fields using the credential map, then save the app record. Begin a new integration, pick that saved app, and only then choose Threads for account authorization. Selecting the app first binds the connection to the intended credentials.

Requested permission identifiers
Permission
threads_basic
threads_content_publish
threads_manage_insights
threads_manage_replies

Request only the capabilities your product uses and complete the provider’s review requirements.

Credential field map
Provider valueBYOK field
Meta app IDclient ID
app secretclient secret

Store the secret in the app record; do not include it in a shared callback URL.

OAuth callback URL
{{API_BASE_URL}}/v1/connect/threads/callback