<% user.full_name %>
<% util.level ? util.level.title : '' %>
Explorer Pioneer Apollo Viking Voyager Pathfinder Orion
Points
<% user.points ? user.points.toLocaleString() : 0 %>
Badges
<% util.badgeCount %>
Streaks
Congratulations You've <% util.newestBadge.isCurriculum ? 'completed' : 'earned' %> the
<% util.newestBadge.title %> <% util.newestBadge.isCurriculum ? 'curriculum' : 'badge' %>!
previous
next
Share to Social Media
Linked In Facebook
Status
<% util.level ? util.level.title : '' %>
<% util.level ? util.level.points : '' %>
<% util.nextLevel ? util.nextLevel.title : '' %>
<% util.nextLevel ? util.nextLevel.points : '' %>
Level up! <% util.levelPointsRemaining %> points to go
Level up! <% util.levelPointsRemaining %> points to go
Badges
Completed Hitchhikers Track Completed Content Track Completed Pages Track Completed Page Builder Track Completed Search Backend Track Completed Search Frontend Theme Track Completed Search UI React Track Completed Solution Templates and the Admin Console Track Completed Technical Skills Track Completed Platform Basics Track Completed Listings Track Completed Reviews Track Completed Industry Overview Track Completed Analytics Track Completed Industry Overview & Product Basics Track Completed Multi-Language Experiences Track Completed Chat Track
<% util.expandBadges ? 'Less' : 'More' %>
Playground Accounts
New +
No Playground Accounts
Create Playground +
View Profile
Log Out loading
Mission Complete! 🚀
Congratulations, you’ve completed your first module!

We hope you enjoy exploring the rest of the site. Please don’t forget to leave us feedback - we are constantly looking to improve. Happy Hitchhiking!
Home
Welcome to Hitchhikers! 👋
To learn more about the platform we encourage you to get started by completing the Hitchhikers Program Track and earning your first badge!
Start Here
Close notification
Guide
Create Custom OAuth Providers
Arrow Back
Completed
Introduction
Introduction
completed
Completed 1
Step 1
Add a New Custom Provider
completed
Completed 2
Step 2
Add a Linked Account
completed
Completed 3
Step 3
Managing Existing Custom Providers and Linked Accounts
completed
home

Step 2: Add a Linked Account

Add a Linked Account

Now that you have defined your Custom Provider, you will likely want to add new Linked Accounts for that service, just as you can add Linked Accounts to any Built-in Provider. Adding a Linked Account can be done one of three ways:

  1. On the Linked Accounts page: navigate to Content > Configuration and click +Add Linked Account for the chosen provider
  2. On your Provider’s specific landing page: click +Add Linked Account in the upper right hand corner

  1. Within the Connectors flow (for a Pull from API Connector): after choosing OAuth as your authentication method, choose +Add Linked Account from the dropdown.

You will then be presented with a modal to add a linked account and select the scopes that you wish to request.

Authorization Code Grant Type

  1. Select at least one scope, and then click Link.
  2. You will likely be prompted by the provider to log into your account and grant access for Yext to access your app.

Client Credentials Grant Type

  1. Select a scope.
  2. Provide the Client ID and Client Secret of the app in your third party account.

Provide Name and ID

Once the authentication setup is complete, you’ll need to provide a specific name and ID for your Linked Account. You may want to use the email you linked as the Name, with the email preceded by the provider ID for the Linked Account ID. For example, you might name your Linked Account jsmith@shopify.com, with the ID shopify.jsmith@shopify.com. Any name used to identify the linked account will work.

Add Access modal

Now that you have successfully linked an account for your custom provider, you can use the account in a Pull from API Connector to authenticate an API request.

From the Connector setup flow, choose OAuth as your authentication method, and you should now be able to see and pick from any Linked Accounts of your Custom Provider (as well as from any Linked Accounts of a Built-in Provider).

light bulb
Note
The generated access token will be sent by our system as a Request Header in the API request, prefixed with “Bearer”. So for example, the key of the Request Header is “Authorization”, and the value might be “Bearer 123”.
<% elem.innerText %>