YesGraph can manage contact importing for you, letting your users import contacts from Gmail, Outlook, Hotmail, Yahoo, and Slack. These are all enabled by default, and they work right out of the box!

However, you’ll notice that when your users import contacts, your users will be asked to prompted to grant YesGraph access to their contacts. If you’d like for that to be your company name instead, you can set up a custom configuration for each service. Here you’ll find setup guides for each one.

Gmail Setup Guide

For a custom Gmail configuration, you’ll need a Google Developer Account, with OAuth credentials (A Client ID, a Client Secret, and an Authorized Redirect URL). Here’s how to get them:

  • Create an account. Do this at https://console.developers.google.com.

  • Create a project. Name the project whatever you like. Your customers won’t see this.

  • Enable the Contacts API. Go to https://console.developers.google.com/apis/library, and select the Contacts API. From the Contacts API page, click Enable.

  • Create API credentials. Go to the API Manager.
    • Click Create Credentials. Get an OAuth Client ID.
    • Under Application Type, select Web application.
    • Under Restrictions, add an Authorized Redirect URI.
Important: Choosing an Authorized Redirect URI

Your Authorized Redirect URI should share a domain with the page where you’ll put the invite widget. So if your widget is on “https://mywebsite.com/referrals”, set this to be “https://mywebsite.com”.

  • Add the Client ID, Client Secret & Authorized Redirect URL to your YesGraph account. Save your new credentials to your YesGraph dashboard, and flip the “Automatic Configuration” switch to “OFF”.

You can find your Client ID and Client Secret here: console.developers.google.com/apis/credentials

And you’re done! Keep reading to get set up with Outlook.

Outlook Setup Guide

For a custom Outlook configuration, you’ll need a Microsoft developer account with OAuth credentials (An Application ID, a Password, and an Authorized Redirect URL.) Let’s get started!

  • Sign In to the Microsoft Application Registration Portal
    • Do this by clicking Register your app on apps.dev.microsoft.com
    • Once you’re signed in, select Skip Quickstart (The quickstart is for a different use case.)
  • Create an App. From the app listing page, click Add an app, and use your company name for the name of your app. Your customers will see this when they authorize you to view their contacts.

  • Get/Create Credentials
    • At this point you should see your Application ID (also called a Client ID in some places). Save this on your YesGraph dashboard as your Outlook Client ID.
    • To create your Client Secret, click Generate New Password in the Application Secrets section. Add it to your YesGraph dashboard as your Outlook Client Secret.

  • Add a Platform.
    • Under the Platform section, click Add Platform, and then select Web.
    • Add a Redirect URI. This can be any URL with the same domain as the page with your contact importer. So if your contact importer is on https://mywebsite.com/invites/ you could set your Redirect URI to https://mywebsite.com.

  • Add your Credentials to YesGraph. Make sure your Client ID, Client Secret, and Redirect URL are copied exactly onto your YesGraph dashboard, and flip the “Automatic Configuration” switch to “OFF”.

That’s it! Keep reading to get setup with Yahoo.

Yahoo Setup Guide

For a custom Yahoo configuration you’ll need a Yahoo developer account with OAuth credentials (a Client ID, a Client Secret, and an authorized callback domain). Let’s get started!

  • Sign in to the Yahoo Developer Network

  • Create an App

    • Set the Application Name to your company name. This is what your customers will see when they authorize you to access their contacts.
    • Under Application Type choose Web Application.
    • Set your Callback Domain to the domain where your contact importer will be. So if your contact importer is on https://www.mydomain.com/referrals, the callback domain should be mydomain.com.
    • Under API Permissions, select Contacts > Read.

Now click Create App to get your credentials!

  • Get credentials. You should now see your Client ID and Client Secret (also called a “Consumer Key” or “Consumer Secret” in some places). Save these to your YesGraph dashboard.

  • Choose an Authorized Redirect URL. On your YesGraph dashboard you’ll be asked for a Yahoo Redirect URL. This can be any URL on the same domain as the Callback Domain from your Yahoo dashboard. So, if you set the Callback Domain to mydomain.com, your Redirect URL could be https://www.mydomain.com/callback.

  • With all your credentials copied onto your YesGraph dashboard, flip the “Automatic Configuration” switch to “OFF”, and you’re ready to go!

And you’re done! Keep reading to get set up with Slack.

Slack Setup Guide

For a custom Slack configuration, you’ll need a Client ID and a Client Secret. Here’s how to get them:

  • Create an App. From the Slack Developer Console, click Create New App, and use your company name for the app name. This is what your customers will see when they authorize you to access their contacts.

  • Add your Credentials to YesGraph. You should now see your App Credentials. Copy your Client ID and Client Secret onto your YesGraph dashboard, and flip the “Automatic Configuration” switch to “OFF”.

That’s it! If you got through all that, you should have a full suite of contact importing services.