Here’s how to configure Discourse to allow login and registration with Instagram OAuth 2.0.
Information regarding developing with Instagram is located at Instagram Developer Documentation.
Browse to Instagram API page Instagram Developer Documentation, then login as the Instagram user associated to the site or create a new user.
1a. Sign up as a Developer if you haven’t already
Select Register Your Application after you signed in as a Developer.
Select Manage Clients and fill in form
- Application name: Discourse Forum name
- Description: Instagram Social Login
- Website URL:
- Valid redirect URLS:
- When form is completed, select Register a New Client
Select Manage to obtain
Sandbox information is here: Sandbox Mode • Instagram Developer Documentation
Client Secretin Discourse. Log into Discourse as an admin user, browse to Admin and enter Client ID (aka
instagram consumer key) and Client Secret (aka
instagram consumer secret) for Instagram login
5a. When logging into Discourse forum using Instagram, select with Instagram and fill in Instagram credentials. Authorize in Instagram popup window.
5b. When creating a new Account using with Instagram , enter Instagram credentials in Instagram window.
After authorization is complete and username is created, enter the email address, as Instagram does not populate that field
Submit App to Instagram. Submission information is here: Permissions Review • Instagram Developer Documentation
Once you are ready to submit your App to Instagram for approval, log into Instagram. In the same Manage Client screen from above, select Permissions tab, then Update Client
Select Start a Submission and answer the following questions.
- Select My app allows people to login with Instagram and share their own content.
- Verify the information entered previously
- Enter API use case
- Create Screencast using the Sandbox credentials
- Select Submit for full permissions from Instagram