How do I use the Slack integration?

Last updated: May 31, 2018

The Slack integration allows you to add tasks to the HubSpot CRM from Slack, receive notifications in Slack when your HubSpot notifications are triggered or you receive an incoming live chat from the messages tool, and use slash commands in Slack to search for contacts and send HubSpot feedback on the integration.

Please note: you need to be a Slack administrator for the workspace you want to install the integration to in order to connect your Slack workspace to HubSpot. If you've already integrated Slack with the messages tool, you won't need to set up the integration again.

Set up the Slack integration

  • In your HubSpot account, click your account name in the top right corner, then click Integrations.
  • Click the All Integrations tab at the top.
  • Search for the Slack integration, then hover over it and click View integration.

  • In the dialog box, click Connect to Slack.
  • You'll be redirected to Slack in a new browser tab. Review the requested permissions, then click Authorize at the bottom right.

Please note:
  • Access to public and private channel content is requested in order to support live chat with website visitors.
  • The HubSpot app in Slack includes commands and message actions.
  • Slack member information is requested in order to associate actions in Slack to the correct HubSpot user in your portal.
  • The HubSpot app in Slack uses reactions to provide message status context for the live chat feature in the messages tool.
  • You'll be redirected back to HubSpot, with a dialog box informing you that Slack for HubSpot was installed. You'll also receive an email from Slack confirming that you've installed the HubSpot app for your Slack workspace.

Add a task to HubSpot in Slack

You can turn any Slack message into a HubSpot task:

  • Hover over a message and click the More actions icon ••• , then select Add a task.
  • In the dialog box, enter a Task titleTask details (the message text will appear here by default), Due date (optional), and select a Task type and the HubSpot user the task will be Assigned to. When you're done, click Save.
  • The task will automatically be created in HubSpot, and the HubSpot app will post a notification in response to the original message in Slack with details about the task that was created.

  • Click 1 reply to open the message thread. To view the task in HubSpot, click the name of the task in the reply message.
  • Within the reply message, you can click Add association to associate a contact, company, or deal with the task. Click Done within the message to finish.

Please note: it's recommended to create tasks from messages in public channels, or private channels that the HubSpot app was invited to. If you create a task from a message in a direct message, group message, or private channel where the HubSpot app wasn't invited, the task will be created in HubSpot but the HubSpot app will not post a notification in Slack.

Manage HubSpot notifications for Slack

The following HubSpot notifications will be triggered as direct messages from the HubSpot app in Slack:

  • Assign
  • Comment
  • Follow
  • Mention
  • Overdue
  • Reminder
  • Reply
  • Submission
  • View (i.e. document view)

Please note: you'll automatically receive your HubSpot notifications within Slack if your HubSpot user email matches that of your Slack user. What can I do if my HubSpot user email doesn't match my Slack user email?

To disable a notification type or specific notification from pushing to Slack:

  • In your HubSpot account, click your account name in the top right corner, then click Profile & Preferences.
  • In the left sidebar menu, click the Notifications sub-menu and select a notification type that's listed above.
  • Click the Integrations tab.
  • Uncheck the Slack box to turn off all the notifications for that notification type, or uncheck the box next to a specific notification to turn individual notifications off.

To check if your notifications are pushing to Slack:

  • In your HubSpot account, navigate to Sales > Tasks.
  • Click Create a Task at the upper right of the tasks dashboard.
  • In the pane that slides in on the right, enter a Title. Under Email reminder, click the Date dropdown and select the current date, then click the Time dropdown and select the next time closest to your current time. Then, click Create.

  • When the time is reached, you'll be notified in Slack of the task via direct message from the HubSpot app. Click View in HubSpot in the message to open the task in HubSpot.

If you're a HubSpot Sales Hub Starter or Professional user, you can also receive notifications about incoming live chats from the messages tool in a dedicated Slack channel, as well as chat with visitors directly through a Slack thread. Learn more about integrating Slack with the messages tool.

Use slash commands to interact with HubSpot

You can use slash commands in Slack to:

  1. Search for and share a HubSpot contact
  • In your channel, click into the reply text box and type /hubspot-search-contact {contact name}, then hit the Enter key.
  • The HubSpot app will return the first three results for the contact name you searched for, which will include the contact's name, profile picture, job title, company name, and email. All results are only visible to your Slack user.
  • To share a contact with your channel, click Post contact to channel.

Please note: the /hubspot-search-contact slash command will only work in public channels, or private channels that the HubSpot app was invited to. The command will show no response in direct messages and group messages, or private channels where the HubSpot app wasn't invited.

  1. Give the HubSpot team feedback about the Slack integration
  • In your channel or direct message with the HubSpot app, click into the reply text box and type /hubspot-feedback {feedback}, then hit the Enter key.
  • In the dialog box, select your Sentiment, enter your feedback into the Details text box (your feedback text will appear here by default), and enter your Name (optional) and Email address (optional). When you're done, click Send.
  • You'll receive confirmation of your feedback submission in a HubSpot app message, which is only visible to your Slack user.

What can I do if my HubSpot user email doesn't match my Slack user email?

If your HubSpot user email doesn't match your Slack user email, you'll receive an email and in-app notification to "Map your HubSpot user's email address to your Slack user" when HubSpot attempts to push a notification to Slack.

  • In the email body, click View in HubSpot.

  • You'll be redirected to the Integrations settings tab of the specific notification type that couldn't be pushed to Slack in a new browser tab or window. Hover over the warning icon warning next to Slack in the upper right, then click Click here to map emails.

  • In the dialog box, enter your Slack email address, then click Verify in Slack.
  • A modal will appear to inform you to go to Slack to confirm your email within the next 24 hours. Click Done and navigate to Slack.
  • In Slack, you'll receive an instant message from the HubSpot app to confirm that you want to map your HubSpot user to your Slack user. Click Verify to proceed.

  • You'll be redirected back to the Integrations settings tab of the notification type in HubSpot in a new browser tab or window. A dialog box will appear to inform you that your email addresses have been successfully mapped, and you'll now receive HubSpot notifications in Slack. Click Done to finish.

Was this article helpful?