Instagram Login Meta app setup
Instagram Login Meta app setup begins with the provider application. Set up a Meta app using Instagram Login, register the OAuth callback, and select permissions for the Instagram features your product exposes.
Callback URL
Register {{API_BASE_URL}}/v1/connect/instagram/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 the Instagram API with Instagram Login product.
- Enter the callback in the Instagram business login OAuth settings.
- Supply the app name, icon, website, privacy policy, data deletion instructions and terms.
- Add Instagram test users during development. Request the necessary 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. Request only permissions used by your product. Leaving unused permissions out usually simplifies App Review.
Save the app before connecting an account
Open Integrations → Apps (BYOK) → New app and select Instagram. 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 Instagram for account authorization. Selecting the app first binds the connection to the intended credentials.
| Permission |
|---|
| instagram_business_basic |
| instagram_business_content_publish |
| instagram_business_manage_insights |
| instagram_business_manage_comments |
| instagram_business_manage_messages |
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/instagram/callback