Twitter OAuth Configuration
If this feature is enabled, Manifold will include a “Log in with Twitter” button on the login page. Clicking the button will open a popup that allows users to authenticate using their Twitter account. On successful authentication, Manifold will create a user record (if it is the user’s first time logging in) and an associated identity record.
These instructions document the process for acquiring OAuth keys from Twitter. It’s possible that their process has changed since this was written. If that’s the case, please open a pull request against our documentation with a correction.
Before adding OAuth support for Twitter to Manifold, you will need a Manifold Twitter app.
- If you do not have one, create a Twitter app through the Twitter App Interface.
The Manifold API handles OAuth callbacks. For Twitter, the callback route is located at
/auth/twitter/callback. For your installation of Manifold, the callback URL will be the fully qualified domain name (FQDN) of the API server followed by that path. For example, my Manifold API is on the same domain as the client application, and that domain is
manifoldapp.org, the callback URL would be
Setup Required URLs
- Log into your account and app at Twitter Apps.
- Navigate to the “Settings” tab.
- In the “Callback URL” field, enter the callback URL, defined above.
- In the Terms of Service field, add a link to your terms of service. This is a required field.
- Save the settings.
Add Permission Settings
- Navigate to the “Permissions” tab.
- Change your app’s Access Level to “Read Only”.
- Check the box to “Request email addresses from users”.
Get App ID and Secret ID
- Navigate to the “Keys and Access Tokens” tab.
- Copy the values under “Consumer Key (API Key)” and “Consumer Secret (API Secret)”.
Update Manifold Settings
Back in Manifold, under the “Twitter” header, enter the Consumer Key into the field labeled
Twitter Consumer Key. Enter the Consumer secret into the field labeled
Twitter Consumer Secret.
Alternatively, if you manage settings in the environment (
MANAGE_SETTINGS_FROM_ENV=1 in your
.env file), you should set the corresponding settings in
# Google OAuth Integration MANIFOLD_SETTING_INTEGRATIONS_TWITTER_APP_ID= MANIFOLD_SETTING_SECRETS_TWITTER_APP_SECRET=