Getting Started

Help Scout provides three tools for developers to get the most out of the product:

  • Custom Apps - push customer data to Help Scout via a webhook callback
  • Help Desk API - read and write data to Help Scout mailboxes
  • Docs API - read and write data to your Docs sites

We suggest spending time with Custom Apps first, because it's an easy way to create a lot of value for people on your team. Simply setup a webhook callback URL and you can push data to the customer sidebar quickly and securely. Start with Custom Apps, then check out the APIs to do something more complicated.

Generating an API Key

The help desk API and Docs API have separate API keys, which are available to paying Help Scout accounts. If you have a Free account, integrations are limited to the Apps listed on this page. Some of those Apps still require an API key, which means you would have to upgrade in order to use them.

To generate a new API key, click the "person" icon on the top right of your account, next to the search, then click Your Profile.

Your Profile

Next, click the API Keys link in the menu on the left.

API Keys

You can generate as many help desk API keys as necessary and label them. However, each User only has one Docs API key. You can't create additional ones or revoke them, all you can do is regenerate the key.

Building a Public Integration

Will you be marketing your project to the public? Awesome! But before you launch anything, please read over our brand guidelines to make sure everything looks tip top. When it's finished, be sure to let us know so we can tell everyone about it.