Custom HubSpot App

Owned by Alex | Ringotel Team
Last updated: Aug 18, 2024
2 min read

Ringotel has an official app on the HubSpot Marketplace. When your customers integrate their HubSpot account via the Ringotel admin portal, they will need to confirm Ringotel app access to their HubSpot account. White-label customers may prefer not to display the Ringotel brand to their clients. Also, if you are using custom domain to access your Ringotel admin portal, enabling integration will result in error due to the incorrectly configured redirect URL. For these reasons creating a custom HubSpot app is a required step.

Create a new HubSpot app

For a complete guide on how to create your own public HubSpot app in your HubSpot developer account, follow the official guide (up to the “Install an app” section): Creating an App.

Firstly, provide your app information in the App Info panel according to your preferences.

When configuring the app, the following public app scopes must be set:

  • crm.objects.companies.read

  • crm.objects.companies.write

  • crm.objects.contacts.read

  • crm.objects.contacts.write

  • crm.objects.owners.read

  • files

  • tickets

Screenshot 2024-02-21 at 20.01.27.png

In the Redirect URLs field, specify the following: https://shell.ringotel.co/services/<YourRingotelAccountID>/Hubspot

You should substitute shell.ringotel.co with your custom Ringotel portal URL, and “<YourRingotelAccountID>” with your Ringotel account ID copied from your Ringotel admin portal → Menu → Account.

Screenshot 2024-08-18 at 16.48.21.png

Click Create app button to create a new app.

Next steps

Once the app is created, you can then publish it to the HubSpot marketplace. Please note, the publication process may take a few weeks and will require communication with the HubSpot review team, as well as additional assets such as app description, video, test accounts for the review team, screenshots, etc. The app publishing is an optional step, which will showcase your integration on the official CRM Marketplace, and add more trust to your application.

However, in most cases, you can avoid lengthy process of approving your app and use the integration within the same day. If you decided not to proceed with the app listing, consider verifying your company domain to remove banner on the install screen that says the app has not been verified.

Lastly, provide us with the details from the App credentials section, such as App ID, Client ID, and Client Secret.

We will then add your custom HubSpot integration to the list of Integrations in your Ringotel admin portal.

Should you have additional questions please contact us at support@ringotel.co