# Breaking Change for v3 Lists API Beta

**URL:** <https://community.hubspot.com/t/breaking-change-for-v3-lists-api-beta/126823>\
**Category:** Developer Announcements\
**Tags:** api, announcement\
**Created:** [February 25, 2025, 3:42pm UTC](https://community.hubspot.com/t/breaking-change-for-v3-lists-api-beta/126823 "2025-02-25T15:42:03Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![dennisedson](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/dennisedson/32/28044_2.png) [@dennisedson](https://community.hubspot.com/u/dennisedson)\
**Post date:** [February 25, 2025, 3:42pm UTC](https://community.hubspot.com/t/breaking-change-for-v3-lists-api-beta/126823/1 "2025-02-25T15:42:03Z")

</div>

The [v3 Lists API beta](https://developers.hubspot.com/docs/reference/api/crm/lists) currently accepts both integers and strings for the ID of public folders used for list segmentation and returns the ID as an integer. **We will be updating the IDs to use only strings** in order to conform to the HubSpot specifications. This will go into effect on April 28th, 2025

![hseligson_0-1716902252719.gif](https://d2qpr2jzcazej7.cloudfront.net/original/2X/d/d5fceb6532643d0d84ffe09c40c481ecdf59e15a.gif)

### What’s Changing

Currently, you can format a public folder ID as either an integer (INT) or a STRING in your request body. Going forward, only strings will be accepted. Furthermore, when getting a response, you should expect to see a string rather than an integer.

Example JSON body of a POST request:

```lia-code-sample
{
"parentFolderId": "139565122",
"name": "Folder of Doom"
}

```

Example JSON body of a response:

```lia-code-sample
{
 "folder": {
 "name": "Folder of Doom",
 "id": "139410347",
 "parentFolderId": "139565122",
 "childLists": [],
 "createdAt": "2025-02-12T19:36:54.021Z",
 "updatedAt": "2025-02-12T19:36:54.021Z",
 "updatedContentsAt": "2025-02-12T19:36:54.021Z",
 "userId": 11176268,
 "childNodes": []
 }
}

```

## 

## **When is it happening?**

This change goes into effect on April 28th, 2025.