HubSpot
HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business.
Go to siteHubSpot API Integrations
Build and run workflows using the HubSpot API. Use 1000s of source-available triggers and actions across 2,000+ apps. Or write custom code to integrate any app or API in seconds.
Overview#
The HubSpot API enables developers to integrate into HubSpots CRM, CMS, Conversations, and other features. It allows for automated management of contacts, companies, deals, and marketing campaigns, enabling custom workflows, data synchronization, and task automation. This streamlines operations and boosts customer engagement, with real-time updates for rapid response to market changes.
import { axios } from "@pipedream/platform"
export default defineComponent({
props: {
hubspot: {
type: "app",
app: "hubspot",
}
},
async run({steps, $}) {
return await axios($, {
url: `https://api.hubapi.com/integrations/v1/me`,
headers: {
Authorization: `Bearer ${this.hubspot.$auth.oauth_access_token}`,
},
})
},
})
Choose an API to Connect with HubSpot API#
1-24of2,000+apps by most popular
Example Use Cases#
Lead Scoring and Segmentation: Enhance leads automatically by pulling in enrichment data from external sources and categorizing them in HubSpot. Use customer interaction data from social media or support platforms to adjust lead scores and segment leads into appropriate marketing campaigns within HubSpot.
Automated Ticketing and Support: Create a workflow where new support queries on HubSpot trigger the creation of tickets in a tool like Zendesk. The workflow can also update the customer record in HubSpot with the ticket information, ensuring the sales team has visibility into customer issues.
Syncing Contacts with Email Platforms: Set up a bi-directional sync between HubSpot and email marketing platforms like Mailchimp. When a contact is updated in HubSpot, it triggers an update in Mailchimp and vice versa. This keeps mailing lists current and enables targeted campaign efforts based on the most relevant data.
Getting Started#
You can install the Pipedream HubSpot app in the Accounts section of your account, or directly in a workflow.
From Accounts
- Visit https://pipedream.com/accounts.
- Click on the Connect An App button in the top-right.
- Search for "HubSpot" among the list of apps, and select it.
- You will be prompted to sign in to HubSpot and select the account you'd like to connect.
- Finally, HubSpot will ask to give Pipedream access to your account. Click "Connect app" to proceed.
- That's it! You can now use this HubSpot account to trigger a workflow, or link it to any code step.
Within a workflow
- Create a new workflow.
- Search for "HubSpot" in the text field when selecting a trigger.
- Select the one of the triggers that appear, based on your use case.
- Click the Connect Account button near the top of the trigger. This will prompt you to select any existing HubSpot accounts you've previously authenticated with Pipedream, or you can select a New account. Clicking New opens a new window asking you to allow Pipedream access to your HubSpot account.
- That's it! You can now connect to the HubSpot API using any of the HubSpot triggers within a Pipedream workflow.
Popular HubSpot Integrations#
Popular HubSpot Actions#
Adds a contact to a specific static list. See the documentation
Create or update a batch of contacts by its ID. See the documentation
Troubleshooting#
By default, a successful HubSpot API request will return a 200 status code alongside the corresponding data payload.
Below are a list of common errors from HubSpots API by HTTP status code.
401 Unauthorized
Returned when the authentication provided is invalid. See our Authentication Overview for details on authenticating API requests.
403 Forbidden
Returned when the authentication provided does not have the proper permissions to access the specific URL. For example, an OAuth token with only content access would receive a 403 error when trying to access the Deals API, which requires contacts access. If your API key or private app has the necessary permissions and you're still encountering this error, please contact HubSpot support for assistance.
429 Too Many Requests
Returned when your account or app exceeds its API rate limits. For suggestions on how to work within those limits, click here.
477 Migration in Progress
Returned when a HubSpot account is in the midst of migration between data hosting locations. In this event, HubSpot provides a Retry-After response header indicating the time in seconds to wait before attempting your request again, typically up to 24 hours.
502/504 Timeouts
Returned when HubSpot's processing limits are reached, which are in place to prevent performance degradation due to excessive requests from a single client. If you encounter these timeouts, pause your requests briefly before retrying.
503 Service Temporarily Unavailable
Returned when HubSpot is temporarily unavailable. Upon receiving this response, take a short break before resuming your requests.
521 Web Server Is Down
Returned when HubSpot's server is down, usually as a temporary issue. If this occurs, pause your requests momentarily, then attempt to reconnect.
522 Connection Timed Out
Returned when the connection between HubSpot and your application times out. Contact HubSpot support if you encounter this error.
523 Origin Is Unreachable
Returned when HubSpot cannot reach your application. If this happens, pause your requests briefly before trying again.
524 Timeout
Returned when a response is not received within 100 seconds, possibly due to HubSpot's server being overloaded. Pause your requests for a short period, then retry.
525/526 SSL Issues
Returned when there's an issue with the SSL certificate or if the SSL handshake fails. In such cases, reach out to HubSpot support for assistance.
Authentication#
HubSpot uses OAuth authentication. When you connect your HubSpot account, Pipedream will open a popup window where you can sign into HubSpot and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any HubSpot API.
Pipedream requests the following authorization scopes when you connect your account:
business-intelligencecrm.lists.readcrm.lists.writecrm.objects.companies.readcrm.objects.companies.writecrm.objects.contacts.readcrm.objects.contacts.writecrm.objects.deals.readcrm.objects.deals.writecrm.objects.quotes.writecrm.objects.owners.readcrm.schemas.companies.readcrm.schemas.companies.writecrm.schemas.contacts.readcrm.schemas.contacts.writecrm.schemas.deals.readcrm.schemas.deals.writeconversations.readcrm.importfilesformsforms-uploaded-filesintegration-syncoauthtimeline- authorization
GEThttps://app.hubspot.com/oauth/authorize?client_id={{oauth.client_id}}&redirect_uri={{oauth.redirect_uri}}&state={{oauth.state}}&response_type=code&scope={{oauth.space_separated_scopes}}&optional_scope=automation content conversations.visitor_identification.tokens.create cms.source_code.read_write e-commerce hubdb sales-email-read social tickets transactional-email crm.objects.custom.read crm.objects.custom.write crm.schemas.custom.read crm.schemas.custom.write - accessToken
POSThttps://api.hubapi.com/oauth/v1/tokencontent-type:application/x-www-form-urlencodedaccept:application/jsonclient_id={{oauth.client_id}}&client_secret={{oauth.client_secret}}&redirect_uri={{oauth.redirect_uri}}&grant_type=authorization_code&code={{oauth.code}} - refreshToken
POSThttps://api.hubapi.com/oauth/v1/tokencontent-type:application/x-www-form-urlencodedaccept:application/jsonclient_id={{oauth.client_id}}&client_secret={{oauth.client_secret}}&grant_type=refresh_token&refresh_token={{oauth.refresh_token}}