Stitch Documentation
has moved!

Please update your bookmarks to

If you're not automatically redirected after 5 seconds, click here.


Connecting your data to Stitch is a simple five step process:

  1. Add Stitch as an app in your account
  2. Retrieve your Key and Secret
  3. Retrieve your Token and Token Secret
  4. Enter your API credentials into Stitch
  5. Define the Replication Frequency


Part of the data imported into Stitch are all labels applied to cases. If you're using Labels in Rules, we recommend setting the label's rule action to "Append" rather than "Set." This will ensure that we capture all labels applied over time.

This can be changed by visiting, replacing "YOURDOMAIN" in the link with your URL, searching for the particular label, and click into the rule to adjust this rule action from ‘Set’ to ‘Append’.

Adding Stitch as an App in Your Account

Steps 1 - 3 of connecting

  1. Log into your account.
  2. Navigate to the Admin panel by clicking the link in the upper left section of the Agent interface.
  3. In the Admin panel, click the Settings option in the menu at the top of the window. 
  4. When the Settings page displays, click the API option in the menu that appears on the left side of the window.

    Need some help navigating the first few steps? Click the image to the right for a quick walkthrough.
  5. Click the +Add API Application button.
  6. After clicking the button, a window will display. This is where the initial parameters for the API application are set. Complete the fields as follows:
    • Name: Stitch
    • Website URL:
    • Callback URL:
    • Support URL:
  7. When finished, click the Add button.

Retrieving Your Key & Secret

  1. After the URL parameters have been successfully submitted, a screen detailing the parameters, Key, and Secret will display.
  2. Copy the Key and Secret into a text file - you'll need easy access to them to complete the setup.

Retrieving Your Token & Token Secret

  1. Click the Your Access Token link on the right side of the API Application page. A window containing your Token and Token Secret will display.
  2. Copy the Token and Token Secret into the text file that contains your Key and Secret. Be careful not to mix up the Secret and Token Secret or you'll encounter errors when saving the integration in Stitch.

Entering Your API Credentials into Stitch

  1. From the Stitch Dashboard page, click the Add an Integration button.
  2. Click the Salesforce Desk icon.
  3. Enter a name for the integration. This is the name that will display on the Stitch dashboard for the integration; it’ll also be used to create the schema in your data warehouse.

    For example, the name “Stitch Desk” would create a schema called stitch_desk in the data warehouse.
  4. In the Site URL field, enter your website address. For example:
  5. Enter your Key, Secret, Token, and Token Secret into their respective fields.

Defining the Replication Frequency

The Replication Frequency setting determines how often Stitch will attempt to replicate data from Desk. By default the frequency is set to 30 minutes, but you can change the interval to better suit your needs.

You can also update this setting at any time in the Integration Settings page.

When you're finished, click the Save Integration button to wrap things up.

Now you can sit back and relax while Stitch replicates your data to your data warehouse.


Was this article helpful?
0 out of 0 found this helpful


Questions or suggestions? If something in our documentation is unclear, let us know in the comments!