Customize a Meta app with the Access the Threads API Use Case

This document shows you how to customize the Access the Threads API use case you added to your app during the app creation process.

Customize use cases

If you are not already on the Use cases page of the dashboard, click Use cases, or the pencil icon, in the left-side menu.
Click on a use case to view the permissions that are available, both required and optional, for this use case.
Click the Add button to the right of each permission you'd like to add. If, during development, you find that your app doesn't use the permission, you can return here and remove it.

Threads API use cases permissions

The following table shows the permissions available for the Threads API use case.

Permission	Usage	Allowed actions
`threads_basic`	Required	Cannot be removed.
`threads_content_publish`	Optional.	Can be added or removed.
`threads_delete`	Optional.	Can be added or removed.
`threads_keyword_search`	Optional.	Can be added or removed.
`threads_location_tagging`	Optional.	Can be added or removed.
`threads_manage_insights`	Optional.	Can be added or removed.
`threads_manage_mentions`	Optional.	Can be added or removed.
`threads_manage_replies`	Optional.	Can be added or removed.
`threads_read_replies`	Optional.	Can be added or removed.

You can add and remove permissions at any time during the development process.

Settings

In the left side menu, click Settings. You'll find your Threads app ID and Threads app secret.
Add the following URLs:
- Client OAuth Settings – valid OAuth redirect URIs
- Deauthorize callback URL – the URL Meta will ping when a user deauthorizes your app
- Data Deletion Requests URL – the URL Meta will ping when someone requests that you delete their data
Click Save.
Click the Add or Remove Threads Test Users to add testers to your app. The page will refresh to the App roles > Roles page in the dashboard.
Click the Add People button to add people as to one or more of the following app roles:
- Adminstrator
- Developers
- Testers
- Analytics Users
- Threads Testers

Webhooks (optional)

A majority of Meta developers use webhooks to get real-time notifications and reduce the number of API calls, and thus reducing the change of rate limiting. Webhooks is automatically added but it is optional.

To receive webhooks from Meta, you need to:

Create an endpoint on your server to receive and process these HTTP notifications
Send a POST request to subscribe your app to webhooks
Configure webhooks in your app's dashboard (the step listed in this section)

To configure webhooks for your use case in the app's dashboard, follow these steps. These steps assumes you are in the Use cases > Customize > Customize use case dashboard and have selected the Webhooks option in the menu.

Select product - In the dropdown select the assets, such as Page and Ad Account, you'd like to be notified about.
Add your Callback URL, the endpoint you created to receive webhooks.
Add your Verify token that Meta will use as part of the callback URL verification.
You can add client authentication to the verification process by sliding Mutual TLS from No to Yes. (Optional)

Note: To receive webhook notifications your app must be published. App Review is not required to use webhooks.

Testing (Optional)

Testing is only required if you are submitting your app for App Review; if your app will access data you don't own or manage.

Click Testing in the left-side menu if you are ready to test your configuration.

Publish

Note: Some use cases require your app to be published.

When you are ready to publish, select Publish in the left side menu.
Review your use cases and requirements.
Click Publish in the lower right corner.

If you would like to become a Tech Provider click Become a Tech Provider.

For Tech Providers

The following steps must be completed if you're a Tech Provider, your app will serve clients or other business portfolios.

App Review

Click the chevron next to each requirement listed under Prepare and submit for App Review. You must complete each requirement before publishing your app.

A checkmark within a circle appears when each of these requirements has been completed.

Learn more about App Review.

Publish your app

Click the chevron to the right of Check that all requirements are met, then publish your app. If any requirements have not yet been met, messaging will appear and you will need to satisfy those requirements.
Once you have successfully completed all the requirements, click Publish in the lower-right corner.

After your app has been published, the Dashboard will show App Health with Daily API Calls.