# Allow API users to specify a number format when creating a number property **URL:** \ **Category:** HubSpot Ideas\ **Tags:** api\ **Created:** [December 29, 2023, 9:12pm UTC](https://community.hubspot.com/t/allow-api-users-to-specify-a-number-format-when-creating-a-number-property/96884 "2023-12-29T21:12:02Z")\ **Posts on this page:** 7\ **Page:** 1
**Author:** ![PCronin9](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/pcronin9/32/195519_2.png) [@PCronin9](https://community.hubspot.com/u/PCronin9)\ **Post date:** [December 29, 2023, 9:12pm UTC](https://community.hubspot.com/t/allow-api-users-to-specify-a-number-format-when-creating-a-number-property/96884/1 "2023-12-29T21:12:02Z")
When using the CRM API to create a number property, it seems they are always created with a default format of “Formatted number”. In the UI, I see that other options available, such as “Unformatted number”, “Currency”, and “Percentage”. It would be nice if there was a way to specify this other format in API calls. ---
**Author:** ![DataHunter](https://avatars.discourse-cdn.com/v4/letter/d/8e7dd6/32.png) [@DataHunter](https://community.hubspot.com/u/DataHunter)\ **Post date:** [April 26, 2024, 2:53pm UTC](https://community.hubspot.com/t/allow-api-users-to-specify-a-number-format-when-creating-a-number-property/96884/2 "2024-04-26T14:53:22Z")
Would be very helpful. I have to create the same property across multiple portals. So the missing currency option is a bit annoying. ---
**Author:** ![JamesBrownI9L](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/jamesbrowni9l/32/203830_2.png) [@JamesBrownI9L](https://community.hubspot.com/u/JamesBrownI9L)\ **Post date:** [September 12, 2024, 8:47pm UTC](https://community.hubspot.com/t/allow-api-users-to-specify-a-number-format-when-creating-a-number-property/96884/3 "2024-09-12T20:47:41Z")
+1 on this. ---
**Author:** ![RupertHSmith](https://avatars.discourse-cdn.com/v4/letter/r/22d042/32.png) [@RupertHSmith](https://community.hubspot.com/u/RupertHSmith)\ **Post date:** [March 20, 2025, 1:56pm UTC](https://community.hubspot.com/t/allow-api-users-to-specify-a-number-format-when-creating-a-number-property/96884/4 "2025-03-20T13:56:42Z")
+1 ---
**Author:** ![RupertHSmith](https://avatars.discourse-cdn.com/v4/letter/r/22d042/32.png) [@RupertHSmith](https://community.hubspot.com/u/RupertHSmith)\ **Post date:** [March 20, 2025, 2:26pm UTC](https://community.hubspot.com/t/allow-api-users-to-specify-a-number-format-when-creating-a-number-property/96884/5 "2025-03-20T14:26:38Z")
I would like to extend this idea to include reading from the V3 properties API where the same issue is present. The ‘read all properties’ API is very powerful for enabling integrations to obtain custom field schemas. However the V3 API has removed a critical field, previously ‘numberDisplayHint’ in the V2 API, which makes the V3 endpoint unusable for applications that need to parse values from HubSpot accurately. Within HubSpot a percentage custom field could be represented as a raw number, or a decimal. I.e. 40% could be either represented as 40 or 0.4 depending whether the user picks a ‘Percentage’ number format. **A concrete example** Our integration needs to extract custom fields from deal records so that we can intelligently update key metrics. However, to accurately parse the fields, it is essential to know whether they are percentages. Otherwise in the example above, 0.4 could be erroneously parsed as 0.4%. In our case, we’ve had to revert to the V2 API which is a great shame as it means we have to use the pass through rather than the excellent, typed Node SDK methods. ---
**Author:** ![knaperek](https://avatars.discourse-cdn.com/v4/letter/k/a9a28c/32.png) [@knaperek](https://community.hubspot.com/u/knaperek)\ **Post date:** [June 20, 2025, 3:12pm UTC](https://community.hubspot.com/t/allow-api-users-to-specify-a-number-format-when-creating-a-number-property/96884/6 "2025-06-20T15:12:15Z")
I need to create a thousand custom properties. I’m surprised this is not available through the API. Appreciate if you could add this. ---
**Author:** ![rwebb1](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/rwebb1/32/2741_2.png) [@rwebb1](https://community.hubspot.com/u/rwebb1)\ **Post date:** [June 1, 2026, 5:30pm UTC](https://community.hubspot.com/t/allow-api-users-to-specify-a-number-format-when-creating-a-number-property/96884/7 "2026-06-01T17:30:30Z")
Hi all - You can now set and read number display format via the CRM Properties API. The `numberDisplayHint` field is available on both the create and update endpoints. The accepted values map directly to what you see in the UI. Docs here: [Create a property - HubSpot docs](https://developers.hubspot.com/docs/api-reference/latest/crm/properties/create-property#body-number-display-hint)