HUhubspot
Basic

Set an app's feature flag

Changed on

Set a feature flag for an app. For example, update the hs-hide-crm-cards flag's defaultState to ON to hide classic CRM cards from new installs.

put/feature-flags/2026-03/{appId}/flags/{flagName}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/feature-flags/2026-03/{appId}/flags/{flagName}
  • Auth
    • HTTP bearer
    • or API key in query parameter hapikey
    • or none

Path parameters

appIdinteger required
flagNamestring required

Request body

defaultState'ABSENT' | 'OFF' | 'ON' required

The state that the flag should have if there are no overrides for a particular portal

overrideState'ABSENT' | 'OFF' | 'ON'

A flag value that supercedes all other overrides, including portal-level values. Mostly used for things like emergency overrides

Response

successful operation

appIdinteger required

The ID of the app

defaultState'ABSENT' | 'OFF' | 'ON' required

The flag state for any portal that doesn't have an override value

flagNamestring required

The name of the flag

overrideState'ABSENT' | 'OFF' | 'ON'

An optional flag value that overrides all others for this flag name and app, including portal-level values

Changes

Some revisions have not been checked yet.