​
What is a Source Guid?

A source_guid is a unique string that is used to identify a data source. It is required when calling the EnsureConnection Job so it knows what to connect to.

​
How can I get the Source Guid?

There are essentially two ways to find out what the Source Guid of a source is.

​
Method 1: Dashboard

You can access your Dashboard to retrieve a Source Guid.
  • Go to your Links page and add a New Link.
  • Select any Link from the list, and click “Create Link”.
  • Click on the “Sources” tab and click on “Add Existing”.
  • Search for the source you want and click on it to automatically add it to the list of sources for your Link.
    (If it isn’t in the list yet, you can click on Create New to add it yourself.)
  • Click on the “EnsureConnection” Job and click the “Select source:” dropdown to change it to the one you just added.
  • The source_guid value will change automatically in the code below to fit the selected source.

​
Method 2: API Reference

You can search for sources via our API Reference enpoint.
  • Open our API Reference and click on the “Link” submenu on the left. It will automatically bring you to a page to “Create a Link Token for running a Link session”.
  • Click on “Try it”, and enter both your Client ID and Sandbox secret in the Authorization section.
    (You can get them from the API Keys page of your Dashboard.)
  • Click “Send”. A response with a link_token value will show up in the top right corner. Copy that value (without the quotation marks).
  • Exit the window by clicking on the empty space around it, then click on “Search sources” in the menu on the left. (Two down from “Create a Link Token”)
  • Click “Try it”, and paste the link_token value in the required field.
  • Enter a keyword in the “search” field to help the system find the source you want.
  • Click “Send”. A list of the top 15 sources (by amount of searches) according to your keyword will come out in the response to the right.
  • Find the exact source you are looking for, and copy its source_id (which is synonym of source_guid in this case).