HubSpot API consistency and completeness has been a major point in feedback from our developer community for some time now. You spoke, and we listened! We are excited to announce the launch of a refreshed CRM API and documentation, available today in developer preview.
The Site Maps API was released when the HubSpot CMS originally launched, and at the time many settings for hosted sites (including things like the navigation) were tied to the settings for the site map. As we've made improvements to our CMS over the years, many of these settings...
What’s happening?
A previously deprecated endpoint for the Companies API that searches for company records by domain name is being sunset. The path of this endpoint is:
On November 1, 2019, we made a change to the Google Analytics integration that will prevent the Google Analytics tracking script from firing until a visitor opts in to cookie tracking via the HubSpot cookie banner.
The field for allowing users to select a workflow in custom modules is being deprecated on December 5th. You won’t be able to create a workflow field when creating new modules in the design manager UI, CMS-CLI, or FTP.
What’s Happening
HubSpot has released a new example using the Ruby language. This example includes the following:
What’s Changing?
HubSpot is changing how validation works on some commonly used fields for contacts, including the first and last name. This change will look for values that are obviously not valid values for the fields.
Deals are central to a CRM. Businesses need to be sure of what the state of their pipeline and closed business is. Deals hold information about completed sales and potential future ones. Because mistakes happen, we are releasing the ability for customers to merge deals together.
You spoke and we listened. We’re excited to announce a new academy course for working with HubSpot’s APIs. If you’re new to APIs or more specifically new to HubSpot’s APIs this will help you get started.
HubSpot forms render a <form> element with a unique id attribute for each page on which the form is used. However, when multiple instances of the same form are added to the same page, the id for each form may not be unique. To resolve this, the id attribute is being changed. If you are targeting...
Today we're announcing new features for the HubSpot tracking code that help you manage sites with dynamic content.
Data security and privacy are very important to us here at HubSpot. Over the coming months, we'll be making updates to our app platform that will help customers better understand what data can be accessed by any apps they're connecting to their HubSpot account.
Getting started with a new API is not always the easiest thing. Sometimes it’s hard to know how to get started. To help make things easier for developers, HubSpot is releasing a number of new examples in PHP and Node.js. There are too many examples to include here but a couple of...
The URL for files uploaded via HubSpot forms now supports two additional forms of authentication. These authentication methods are available in addition to the existing, browser-based authentication. Files can now be accessed using our standard authentication methods:
As part of our ongoing efforts to improve transparency regarding what data connected apps have access to, we're adding a new scope that controls access to the content of email engagements.
This update features information about a new JS minifier and about API Key rotation best practices and tools to help you remember to rotate those key.
We’re upgrading our javascript minification to use terser. The new JS minifier should in most cases shrink...
We are adding the availability of a PATCH Method for use when updating the CRM Object Properties. This will allow for updating ONLY the fields that are included with the PATCH request. Any omitted fields will not be updated and will retain their current value.
In an effort to make error messages from the HubSpot APIs cleaner and easier to understand, we'll be making a few changes to the fields included in our error responses.
This change has been deployed. New uploaded form files will have the new Url format and will require HubSpot authentication to access. Existing form files will be migrated to the new authenticated urls over the next couple days.
We are going to change form file upload urls...
We are going to restrict number property values in the API to contain only numeric digits, an optional single negative sign ("-"), and an optional single decimal point represented by a period/dot symbol.Attempts to save values on numeric properties with commas, spaces or multiple...
Update: this scheduled maintenance has been complete.
The Contacts API will be undergoing maintenance between 5:00 PM and 5:30 PM ET on Sunday, September 29th. During this maintenance period, there will be a brief period where the Contacts API will be unavailable, and any requests to the API will...
We've released a set of new functions for manipulating lists in HubL. These functions enable you to work with lists more easily.
Originally launched in early 2018, the Ecommerce Bridge API allows your integration to connect any ecommerce store with HubSpot, allowing customers to use HubSpot's powerful ecommerce features with any ecommerce store or platform.
Update: maintenance is complete!
The Engagements API will be undergoing maintenance between 5:00 PM and 6:00 PM Eastern Time Sunday, September 15. During this maintenance period, there will be a brief period where the Engagements API will be unavailable, and any requests to the API will result in...
For this week’s round up we rolled 3 updates together with an improved experience in the developer tools and 2 APIs moving from developer preview to general availability.
Data privacy is a top priority at HubSpot, and helping our developer community stay on top of data compliance is important to us. HubSpot users have the ability to permanently delete a contact record to comply with privacy laws. You can see more details about this feature in this help article: ...
For this post we rolled 5 updates into one with a new header to help with Webhook validation, a new callback for embedded forms, added flexibility for content developers, a number of documentation updates, and a small update to the Developer’s Terms of Service.
What’s happening?
Update: Maintenance is complete!
The Timeline API will be undergoing maintenance between 5:00 PM and 6:00 PM Eastern Time Sunday, August 11. During this maintenance period, there will be a brief period where the Timeline API will be unavailable, and any requests to the API will result in 503...
Update: These changes are now live, and the demo API key will only be allowed to make GET requests.
When HubSpot launched our first public APIs in 2010, we created our public API demo account so that developers would have an account that could be used to test those new APIs. This was years before...
Today we are announcing three new updates to Developer Accounts. A new home screen for Developer Accounts, masking the client secret, and adding an option to specify a redirect URL for your applications.
We’re experimenting with batching sunset updates every other week. We hope this will improve your experience as a developer community. Please let us know what you think using the community links below.
Edit: This is now live. If you have any questions or comments, join the discussion on our forum post
We’re excited to share that in the coming weeks, HubSpot will be making some significant changes to our API Limits for all developers, customers, and users of HubSpot.
Update: These changes are now live
Today we're releasing an update for our Ecommerce Bridge API. The v2 release of the Ecommerce Bridge has some new features, but is backwards compatible with the v1 API.
What’s happening?
Today, we’re releasing a new attribute to the context object within the forms v3 endpoint which enables users to enroll contacts directly into goToWebinar webinars via the API.
What’s happening?
To maintain the privacy of contacts within the HubSpot database, we will be sunsetting the ability to pull the IP address of Contacts via HubSpot’s API or the exports of email event (emailEvents) records.
Geo-location data (e.g. city, state, region, country, timezone, etc.)...
What’s happening?
In an effort to enforce the highest security standards, basic authentication is being removed from webhooks within workflows. There’s a new, more secure way to help you verify your webhook requests coming from HubSpot. This is done with request signatures. Using request...
What’s happening?
In an effort to enforce the highest security standards, basic authentication is being removed from webhooks. There’s a new, more secure way to help you verify your webhook requests coming from HubSpot. This is done with request signatures. Using request signatures, HubSpot...
The original v1 of the Forms API was released in sync with the launch of our then new form tools. Since then, we've added several new features to our forms, including support for progressive and dependant fields, support for inline thank you messages, and new styling options for columns and rows...
Update: The HubSpot Developers Forum has been fully migrated to community.hubspot.com. The older Developer Forums on integration.hubspot.com are now read-only.
When the HubSpot CRM originally launched, contacts could only be associated with a single company. This association was done using the associatedcompanyid, since only a single association from a contact to a single company was supported. Since then, we've added new objects, such as tickets and...
Today, we're releasing a new endpoint for our Forms API that will let you get the details for individual submissions for a HubSpot form. This will include all of the fields included in the submission, as well as the time that the form was submitted and the page that the form was...
Previously users of the Native Shopify integration and the ecommerce bridge APIs were provided with three out-of-the-box ecommerce workflows that were hard-coded to 3 email triggers and 3 time delays. Moving forward, users will have complete flexibility to customize their embedded...
Along with a portal’s Timezone (e.g. US/Eastern), the `/integrations/v1/me` endpoint now returns UTC Offset information, which should make it easier for developers to localize timestamps that HubSpot’s API returns. Going forward, this endpoint will include a human readable...
Beginning on January 7, the developer forums will be migrated from integrate.hubspot.com to community.hubspot.com --- the same platform as the HubSpot customer and CMS developer forums. The migration will conclude on January 29th.
Failed webhook notifications are now retried over the course of 24 hours, with some delay randomization.
Today we're releasing a new endpoint for the Analytics API. This endpoint will let you check to see if there is existing analytics data for any of the specific objects supported by the Analytics API. This will allow you to perform a quick check to see if data exists before making...
Update: The deadline to migrate existing HTTP webhook URLs is being moved from Tuesday, December 4th 2018 to Tuesday, January 15th 2019.
The sunset of the Public Contact Record is being moved from December 20th to January 23rd.
Ask technical questions and get answers! Join us for this free, virtual developer event on Wednesday - December 12th, 2018 at 9 am PT / 12pm ET. Submit your technical questions in advance and a panel of HubSpot development experts will answer them in detail.
Today, we're releasing a few new features for the Ecommerce Bridge to help you track down sync errors. We're releasing two new endpoints, and adding additional functionality to the existing sync errors endpoint to make it easier to find specific errors.
This is a reminder that the previously announced issue where some HTTP requests that should result in an error response are incorrectly returning HTTP 200 status codes will be going live tomorrow morning (November 13 2018).
Sunset: "quota" field will no longer be provided by the Owners API
New feature: Check the sync status of a specific object
New feature: Rate limit information headers
New Content: OAuth 2.0 Quickstart Guide and companion Quickstart App
All new webhook URLs are required to use HTTPS, and all existing URLs will be required to use HTTPS starting December 4th.
Join us on October 26th at 9 am PT / 12 pm ET for an overview of the latest developer releases and an AMA with members of our product and engineering teams who will be available to answer any of your questions!
The public contact record is being sunset on December 20th
We've identified an issue where certain requests that should result in an error response are incorrectly returning responses with HTTP 200 status codes and an empty response body.
CRM Associations API is no longer in Developer Preview.
New Marketing Professional portals will no longer have access to the workflow webhook action starting November 1st. New Marketing Enterprise and existing Marketing Professional portals will continue to have access going forward.
New Functionality: Embeddable view of a HubSpot contact's timeline.
New functionality: Ability to manage parent <-> child company relationship via API
New functionality: Programmable actions for bots
New functionality: Analytics API now supports pulling data for custom events & using analytics views.
New Functionality: Workflow performance metrics endpoint
New functionality: Global form events added
Keywords API will be sunset on August 1st, 2018
Site Search API released: 1 new endpoint available
Ecommerce Bridge API released; 12 new endpoints now available
Version 2 of the HubDB API released, now includes draft table functionality.
Integrators can add support information to their in-app listing via their app settings in their developer portal
The Forms API no longer allows write access to non-marketing forms. Non-marketing forms will no longer be returned by default by the 'Get all forms' endpoint effective May 21st 2018.
New endpoint: Get Lifecycle Stage metrics
Timeline event properties of type 'string' now support 'does not contain', 'starts with', 'ends with', 'is known', and 'is unknown' filters when creating lists.
New endpoint: Get Contact Property Group Details.
OAuth2 redirect_uri can now be served over http if the host is localhost
'Get account details' endpoint now includes the portal's selected currency
JSON structure of deal-related workflow actions changed; some top-level deal action properties moved into a substructure.
Keywords API will be sunset on June 1st, 2018