Learn how to define app objects on the latest version of the developer platform.
Last modified: September 3, 2025
This feature requires approval from HubSpot to use. If you’re interested in applying to get access to app objects, or if you want to learn more about the functionality, please submit this in-app form.
App objects provide the same flexibility of custom objects (i.e., a unique name and customized schema definition) in tandem with the ability to standardize and manage that schema definition across all accounts that install your app.After a HubSpot user installs an app with support for app objects, they can consult this Knowledge Base article for details on how to use them in different tools within their account.
The quickstart guide walks you through how to get up and running with a proof-of-concept app that uses a boilerplate example project and schema definition for an app object. You can then upload the associated configuration files to a project in your developer account, and test out an install using a developer test account.
The app objects reference article provides details for the required directory structure of your app, along with example schema files, including configuration file definitions. The article also provides important caveats such as limits imposed during the private beta, and additional callouts you should keep in mind as you build your app.