Connect your app to Goodreads
To configure a Goodreads connection with Auth0, you will need to register your app on the Goodreads developers site.
1. Apply for a developer key
Log into the Goodreads developer site, and select developer key:
2. Enter information about your app
Complete the form then click Apply for a Developer Key. Enter your callback URL in the
Callback URL field:
Find your Auth0 domain name for redirects
If your Auth0 domain name is not shown above and you are not using our custom domains feature, your domain name is your tenant name, plus
.auth0.com. For example, if your tenant name were
exampleco-enterprises, your Auth0 domain name would be
exampleco-enterprises.auth0.com and your redirect URI would be
If you are using custom domains, your redirect URI will have the following format:
https://<YOUR CUSTOM DOMAIN>/login/callback.
3. Get your Consumer Key and Consumer Secret
Once the application is registered, the Key and Secret for your new app will be displayed on the following page:
4. Create the Goodreads connection
You will need to use this endpoint of our Management API v2 to create a custom
oauth1 connection for Goodreads.
Read our documentation on creating generic OAuth1 connections for more information on the individual fields used in the sample payload to follow. For Goodreads, this is a sample payload to create the connection:
This sample uses the following
fetchUserProfile script, you can change it as you please:
Goodreads returns limited user profile data
If you have any Rules configured that rely on
user.email for example, user authentication will likely fail - the sample Rule above currently only returns
user.link properties from Goodreads' API. Please add appropriate error handling to any Rules or Hooks that may rely on other user-profile data that may be missing. You may use our Real-time Webtask Logs extension to help debug these sorts of issues further.
If you do change the
fetchUserProfile script, you can stringify the function easily for use in your
POST /api/v2/connections payload as follows:
5. Test the connection
You can use the /authorize endpoint with custom
connection parameters to test your connection. For example: