HubSpot IGNITE Program Resources

Session 1: API Best Practices for Public Apps
Join the HubSpot IGNITE series' inaugural session to enhance your development skills within the HubSpot ecosystem. Hosted by developer advocate David Adams and the DevRel team, this session covers API best practices for public apps, focusing on data batching, webhooks, app integrations, and more.
Session 2: Envisioning the Future of Your App. Insights from HubSpot's Product Managers
Check out the second IGNITE event video featuring five HubSpot specialists from our product management and solution architecture teams. Watch as we dive into the future roadmap, sharing insights on custom cards, marketplace reporting, developer tooling innovations, Conversations, and Messaging. Stay ahead of the game with exclusive key takeaways and expert perspectives on the exciting developments coming your way!
Session 3: API Best Practices 2.0 and Go-To-Market Strategies
Join Hannah Seligson, and Jesse Cunningham from HubSpot as they dive deeper into effective API practices, introduce key resources like the HubSpot Postman workspace, and provide hands-on demos and use cases. This session also covers essential go-to-market strategies, successful partner stories, and critical updates for developers. Perfect for anyone looking to optimize their integration with HubSpot and drive greater success. Don't miss the valuable tips, Q&A, and practical insights!

Batch calls can be more efficient than pagination when you already have IDs or email addresses. Utilize the Lists API to get specific records, then use batch operations to retrieve details. Use pagination with the "get all" endpoints for initial syncs or large data retrievals. Consider using the async export API for very large datasets that do not require real-time sync. Balance between batch operations and pagination based on your specific use case and data volume.

Strategies to consider with rate limits include: Implementing caching for data that doesn't change frequently. Prioritize batch operations over individual calls whenever possible. Store and reuse object IDs to minimize unnecessary lookups. Refactor your app's logic to reduce redundant API calls. Utilize webhooks for real-time updates instead of frequent polling.

Currently, there's no built-in webhook for app uninstallations. The best practice is to monitor if the refresh token is still valid for each portal. It is recommended to check if refreshing the access token fails multiple times in a row, then check the refresh token. For canceled accounts generating excessive webhooks, reach out to HubSpot app support.

Custom UI for CRM cards is being actively explored for public apps. It is encouraged to start envisioning potential use for custom UI in CRM cards and build these in private apps to demonstrate these use cases.

The latest version of the List API is referencing the UI list ID and we are actively working on a solution. In the short term, consider implementing a system to map between UI and technical list IDs in your app and use the #list-api-v3 channel in the HubSpot Developer Community Slack for updates and questions on this issue.

Optional scopes are app-specific and not user-selectable during installation. If a user doesn't have access to an optional scope, it is dropped automatically by HubSpot before the user is asked to approve the scope during the installation process. Users with access see all applicable scopes without the ability to uncheck them. This feature allows apps to support different HubSpot user tiers with varying functionalities.

After installation, you should check the details of the refresh token when it's initially generated to confirm which scopes were actually approved for the user.

Build your app functionality based on features rather than HubSpot tiers, as pricing and packaging may change. Use scopes to determine available functionality for each user. Leverage the advanced scope settings in app settings to set optional scopes for multi-tier support. Focus on feature-based design rather than trying to determine exact subscription tiers. Regularly review and update your app design as HubSpot introduces new features and changes.

The updated Service Hub uses the same object model as before. We've updated some APIs, and we're currently in Beta with our Conversations inbox & messaging API. You can also continue to make use of the Tickets API for integrations.

When using the Custom Workflow Actions API, determine the right endpoints you need for your required functionality. Additionally, determine if you should use a separate process using our batch endpoints instead of a Custom Workflow Action to maximize API call efficiency. Finally, keep updated with the latest changes to the API. Check out the API guide on Custom Workflow Actions for more information.

For general questions on how to use the APIs, the first step should be the HubSpot Developer Community. This is the primary resource for getting help with API usage and understanding functionality. If you believe you've encountered a bug, contact HubSpot's Support Team directly. This process ensures that a case number and a bug report are created so issues can be properly tracked and escalated to the engineering team if needed.

The new Lists API expands on the original Contacts List API. By decoupling the Lists API from contacts, the new API works with multiple CRM object types, so you can segment companies, tickets, deals, and more into dynamic or static lists.

Understanding the CRM

The foundation of your HubSpot account is a database of your business relationships and processes, called the CRM.

Learn more about the CRM

Public Apps

A public app is a type of integration that can be installed on customer accounts or listed on the App Marketplace

Learn more about Public Apps

CRM Imports API

Use the imports API to import CRM records and activities into your HubSpot account, such as contacts, companies, and notes.

View the CRM Imports API

CRM Exports API

Use the exports API to export records and property data from your HubSpot account, retrieve a URL to download an export file, or see the status of an export.

View the CRM Exports API

Webhooks API

The Webhooks API allows you to subscribe to events happening in a HubSpot account with your integration installed.

View the Webhooks API

Lists API

Lists are a collection of records of the same object type that can be used for record segmentation, filtering, and grouping to serve your business needs.

View the Lists API

Extensions overview

Using extensions, you can customize the functionality of the HubSpot CRM.

Learn more about Extensions

Create a settings page for your app

Create a settings page for your public app to give users more control over how they use your app in their HubSpot account.

Learn more about creating a settings page

Calling Extensions SDK

The Calling Extensions SDK allows apps to provide a custom calling option to HubSpot users directly from a record in the CRM.

View the Calling Extension SDK

Video Conference Extension

The Video Conference API gives integrators the ability to plug into the meeting creation flow within HubSpot and add video conference information.

View the Video Conference Extension

Dennis Edson, Developer Advocate at HubSpot, gives a walkthrough on how to use HubSpot with Postman to, test and share APIs.

In this video, our technical lead, Alonso Cadenas, walks you through the exciting features of our new demo app and how to make the most out of it.

This video provides a comprehensive walkthrough of the declarative scope groups UI, detailing the various types of scopes - required, conditionally required, and optional - and explaining how they function within the UI.

A Developer's Guide to HubSpot CRM Objects: Standard Objects

Welcome to the first entry in a new blog series designed to support developers diving into the HubSpot CRM. Throughout the year, we will be releasing a collection of posts that provide a technical perspective on harnessing HubSpot CRM’s capabilities, starting with an introduction to its core: the standard objects.

Read our guide to Standard Objects

A Developer's Guide to HubSpot CRM Objects: Contacts Object

Welcome back to our series, "A Developer's Guide to HubSpot CRM Objects." In our first post, we introduced you all to HubSpot standard objects. However, in this second post, we will delve into one of the most fundamental components of the HubSpot CRM: the Contacts object.

Read our guide to the Contacts Object

A Developer's Guide to HubSpot CRM Objects: Company Object

In HubSpot’s CRM (customer relationship management) platform, understanding the different objects and how they interconnect is crucial for developers leveraging the platform's full potential. Now, we are diving into one of the core HubSpot CRM entities: the company object. Companies within HubSpot are the backbone for storing and organizing information about the businesses and organizations a business interacts with.

Read our guide to the Company Object

When to Use CRM Search API vs. Object-Specific APIs

Navigating through HubSpot's APIs can be a bit like choosing the right tool for a job. Sometimes, you need the precision of a scalpel, and other times, you need the broad reach of a net. In the world of HubSpot, this translates to knowing when to use the CRM Search API and when to opt for an object-specific API. Let's dive in and demystify when to use each!

Read when to use CRM Search API vs. Object-Specific APIs

Harnessing the Power of HubSpot's Public APIs with Postman

Explore HubSpot's powerful APIs with Postman. This guide introduces you to HubSpot's new Postman workspace, simplifying API testing and custom integrations. Guiding you how to test HubSpot APIs easily with up-to-date API definitions at your fingertips.

Read about harnessing the power of HubSpot's public APIs with Postman

Sign up for the Developer Newsletter

In addition to occasional special announcements, you'll get a monthly roundup with developer updates, relevant product news, and other information that will help you grow as a developer on our platform and beyond.

Join the Developer Slack

HubSpot's Developer Slack is a dedicated community for HubSpot's developers to gather for developer-to-developer support and collaboration around the HubSpot platform.

Join the Slack

View and subscribe to the Developer Changelog

Stay current with the latest changes and updates happening that affect HubSpot developers. Learn about new functionality, announcements of sunsets/deprecations etc.

View and subscribe

HubSpot IGNITE Resources

Previously Recorded Sessions

Session 1: API Best Practices for Public Apps

Session 2: Envisioning the Future of Your App. Insights from HubSpot's Product Managers

Session 3: API Best Practices 2.0 and Go-To-Market Strategies

Session Q&A

Session 1

Session 2

Session 3