GUIDE / THREADS ACCESS TOKEN

Eighteen steps.One access token.

Your dashboard is deployed — now it needs a key to your Threads data. Follow one screenshot per step through Meta for Developers and walk away with a long-lived Threads access token.

About 10 minutes · Free · No code involved

BEFORE YOU START
  • A Facebook / Meta account that can sign in to Meta for Developers
  • A public Threads account
  • Access to the Threads account that will accept the tester invitation

This flow covers personal and testing use. Supporting non-test users usually requires App Review and publishing the app.

WHAT YOU LEAVE WITHLong-lived Threads access token

01 / STEPS 1–6

Create the Meta app

Six screens of the app-creation wizard — name it, pick the Threads API use case, and skip everything optional.

Open Meta Developers and create an app

Open developers.facebook.com/apps and click Create App in the top-right corner of the Apps page.

developers.facebook.comSTEP 1
Open Meta Developers and create an app

Enter app details

On the Create an app page, fill in the two fields, then click Next.

  • App name — for example, Threads Analytics
  • App contact email — your contact email
developers.facebook.comSTEP 2
Enter app details

Select the Threads API use case

On the Add use cases page, find Access the Threads API, select the checkbox on the right, and click Next.

developers.facebook.comSTEP 3
Select the Threads API use case

Skip the business portfolio

On the business portfolio step, select I don't want to connect a business portfolio yet., then click Next.

developers.facebook.comSTEP 4
Skip the business portfolio

Confirm publishing requirements

When the page shows No requirements identified, there is nothing extra to prepare for this setup. Click Next.

developers.facebook.comSTEP 5
Confirm publishing requirements

Create the app

On the Overview page, confirm the app name, email, use case, business, and requirements, then click Create app in the bottom-right corner.

developers.facebook.comSTEP 6
Create the app

02 / STEPS 7–12

Invite a Threads Tester

Open the use case settings and hand the tester role to the Threads account that owns the data.

Open Use cases

The Dashboard appears once the app is created. Click Use cases in the left sidebar.

developers.facebook.comSTEP 7
Open Use cases

Customize the Threads API use case

On the Use cases page, find Access the Threads API and click Customize.

developers.facebook.comSTEP 8
Customize the Threads API use case

Open Settings

Inside Customize use case, the left panel shows Permissions and features and Settings. Click Settings.

developers.facebook.comSTEP 9
Open Settings

Open Threads Tester management

At the bottom of the Settings page, find User Token Generator and click Add or Remove Threads Testers. The same page also lists:

  • Threads app ID
  • Threads app secret
  • Threads Display Name
  • User Token Generator
developers.facebook.comSTEP 10
Open Threads Tester management

Add people

You land on the App roles page. Click Add People in the top-right corner.

developers.facebook.comSTEP 11
Add people

Assign the Threads Tester role

In the Add people to your app dialog:

  • Select Threads Tester
  • Search for and select the Threads account that should generate the token
  • Click Add

The invited account must be a public Threads account and has to accept the invitation from Threads. If it doesn't appear in search, confirm the user has a Meta developer account and a public Threads profile.

developers.facebook.comSTEP 12
Assign the Threads Tester role

03 / STEPS 13–14

Accept in Threads

Switch to the invited Threads account for two clicks — the invitation is waiting under website permissions.

Open website permissions in Threads

With the invited Threads account, open Threads on the web. Go to More settings, then click Website permissions.

threads.comSTEP 13
Open website permissions in Threads

Accept the tester invitation

In the Invites tab, find the app you created — for example Threads Analytics — and click Accept.

threads.comSTEP 14
Accept the tester invitation

04 / STEPS 15–18

Generate the token

Back in Meta Developers: generate, authorize, copy. The long-lived token is yours.

Return to Threads API Settings

Back in Meta Developers, go to Use casesAccess the Threads APICustomize, then click Settings in the left panel.

developers.facebook.comSTEP 15
Return to Threads API Settings

Generate the access token

In User Token Generator, find the Threads Tester that accepted the invitation and click Generate Access Token on the right.

developers.facebook.comSTEP 16
Generate the access token

Confirm authorization

The authorization page lists the Threads permissions the app will receive. Confirm the account is correct, then click Continue As ….

If you open Edit access, keep the data and insights permissions enabled — without them the token can't sync analytics data.

threads.comSTEP 17
Confirm authorization

Copy the access token

Back in Meta Developers, the token dialog appears. Select I understand, then click Copy to copy your long-lived Threads access token.

developers.facebook.comSTEP 18
Copy the access token

AFTER THE TOKEN

Token copied? Bring it home.

Paste it into your dashboard under Settings → Add Threads account and run the first sync.

Threads access tokens expire. If syncing fails or the token is close to expiry, repeat the same flow to generate a fresh one.