Skip to content

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

  1. Create an app in Meta for Developers and add the Instagram API with Instagram Login product.
  2. Enter the callback in the Instagram business login OAuth settings.
  3. Supply the app name, icon, website, privacy policy, data deletion instructions and terms.
  4. Add Instagram test users during development. Request the necessary 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. 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.

Requested permission identifiers
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.

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/instagram/callback