# \[New\] Formula custom fields

**URL:** <https://forum.asana.com/t/new-formula-custom-fields/593057>\
**Category:** Changelog\
**Tags:** custom-fields-api, api, new-api\
**Created:** [3 November 2023 04:41 UTC](https://forum.asana.com/t/new-formula-custom-fields/593057 "2023-11-03T04:41:37Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Andrew-asana](https://luna1.co/8d76cd.png) [@Andrew-asana](https://forum.asana.com/u/Andrew-asana)\
**Post date:** [3 November 2023 04:41 UTC](https://forum.asana.com/t/new-formula-custom-fields/593057/1 "2023-11-03T04:41:37Z")

</div>

## Summary

You can now programmatically leverage the capabilities of Asana’s [formula](https://help.asana.com/hc/en-us/articles/15956483311259-Formula-custom-fields) custom fields with the API. These fields enable you to perform calculations and manage data within Asana.

 ![Screenshot 2023-11-02 at 9.28.41 PM](https://us1.discourse-cdn.com/asana/original/3X/0/3/03026bbb243fa704bdafce08a09c3d1d09739326.png)

## Usage

[Custom fields schemas](https://developers.asana.com/reference/custom-fields) now includes an `is_formula_field` property, a boolean value that describes whether a field is a _formula_ custom field.

Here’s an example of the custom field object returned for the formula custom field from the above screenshot:

```auto
{
    "gid": "12345",
    "enabled": true,
    "name": "Time to completion",
    "description": "",
    "number_value": 225023,
    "precision": 0,
    "created_by": {
    "gid": "54321",
           "name": "Andrew",
           "resource_type": "user"
    },
     "display_value": "22w 2d",
     "resource_subtype": "number",
     "resource_type": "custom_field",
     "is_formula_field": true,
     "is_value_read_only": true,
     "type": "number"
}

```

For additional guidance on using custom fields in the API, see the [custom fields guide](https://developers.asana.com/docs/custom-fields-guide).

### Special considerations

Please take note that in the current state, formula custom fields are presented and managed as `number` custom fields in the API. It’s important to also be aware that, as of now, you cannot create or update values for formula custom fields through the API.

### Questions & feedback

Formula custom fields empowers users to conduct an extensive array of calculations within Asana. We’re excited to hear your feedback and field any questions as you add this new feature to your apps.

Happy coding!

Best,  
Andrew

---

<div class="post-metadata">

**Author:** ![Andrew-asana](https://luna1.co/8d76cd.png) [@Andrew-asana](https://forum.asana.com/u/Andrew-asana)\
**Post date:** [3 November 2023 05:00 UTC](https://forum.asana.com/t/new-formula-custom-fields/593057/2 "2023-11-03T05:00:18Z")

</div>

Closed on 3 November 2023 05:00 UTC



---

<div class="post-metadata">

**Author:** ![Jeff\_Schneider](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/jeff_schneider/32/146_2.png) [@Jeff\_Schneider](https://forum.asana.com/u/Jeff_Schneider)\
**Post date:** [5 December 2023 21:22 UTC](https://forum.asana.com/t/new-formula-custom-fields/593057/3 "2023-12-05T21:22:09Z")

</div>

Opened on 5 December 2023 21:22 UTC