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
- Create an app in Meta for Developers and add Threads API.
- Register the callback in the Threads OAuth redirect settings.
- Complete the app’s public details and add Threads test users.
- Request the listed permissions through App Review before production use.
- 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.
| 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.
| Provider value | BYOK field |
|---|---|
| Meta app ID | client ID |
| app secret | client secret |
Store the secret in the app record; do not include it in a shared callback URL.
{{API_BASE_URL}}/v1/connect/threads/callback