# Use Segments (Lists) API and App Events

**URL:** <https://community.hubspot.com/t/use-segments-lists-api-and-app-events/150439>\
**Category:** APIs & Integrations\
**Tags:** api\
**Created:** [June 16, 2026, 8:34am UTC](https://community.hubspot.com/t/use-segments-lists-api-and-app-events/150439 "2026-06-16T08:34:41Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![yoLotus](https://avatars.discourse-cdn.com/v4/letter/y/e99b99/32.png) [@yoLotus](https://community.hubspot.com/u/yoLotus)\
**Post date:** [June 16, 2026, 8:34am UTC](https://community.hubspot.com/t/use-segments-lists-api-and-app-events/150439/1 "2026-06-16T08:34:41Z")

</div>

Hello folks,  
I migrated a legacy app to the latest 2026.03 project platform using `hs project upgrade.` As a result, all existing timeline events were migrated into a set of JSON files inside the project.  
Each app event now has _a fully qualified name_ following this pattern: `<app-id>-internal-event-name-<old-timeline-id>`

I’m now trying to create contact segments (lists) through the API using these new app events.  
My payload looks like this:

`{ filterBranchType: 'OR', filterBranchOperator: 'OR', filters: [], filterBranches: [{ filterBranchType: 'AND', filterBranchOperator: 'AND', filters: [], filterBranches: [{ filterBranchType: 'UNIFIED_EVENTS', filterBranchOperator: 'AND', filterBranches: [], eventTypeId: 'using the fully qualified name here', operator: 'HAS_COMPLETED', filters: [{ filterType: 'PROPERTY', property: 'myProperty', operation: { operationType: 'STRING', operator: 'IS_EQUAL_TO', value: 'a given value' } }] } ] } ] }`

However, I’m getting this error:

`[400]: { "status": "error", "message": "Unable to infer object type from: ad906381_integrators-timeline-event-type-id-1150444", "correlationId": "corrId" }`

It looks like the API does not accept the _fully qualified name_ as the eventTypeId, but after the migration I don’t see another unique identifier I can use for these new app events.  
Has anyone successfully created HubSpot Lists/segments based on migrated app events from the new project platform? What is the correct identifier to use for eventTypeId in this case?  
Thanks!

---

<div class="post-metadata">

**Author:** ![yoLotus](https://avatars.discourse-cdn.com/v4/letter/y/e99b99/32.png) [@yoLotus](https://community.hubspot.com/u/yoLotus)\
**Post date:** [June 16, 2026, 8:38am UTC](https://community.hubspot.com/t/use-segments-lists-api-and-app-events/150439/2 "2026-06-16T08:38:55Z")

</div>

I wasn’t expected such indentation for the payload. Find a proper paylaod indentation here =\> [https://www.jsonblob.com/019ecf94-803e-7b26-945c-3fe5c5d48c49](https://www.jsonblob.com/019ecf94-803e-7b26-945c-3fe5c5d48c49)

---

<div class="post-metadata">

**Author:** ![Berangere](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/berangere/32/220784_2.png) [@Berangere](https://community.hubspot.com/u/Berangere)\
**Post date:** [June 16, 2026, 3:58pm UTC](https://community.hubspot.com/t/use-segments-lists-api-and-app-events/150439/4 "2026-06-16T15:58:16Z")

</div>

Hi @yoLotus and thanks for reaching out to the HubSpot Community!

When looking at “[List (segment) filters overview](https://developers.hubspot.com/docs/api-reference/latest/crm/lists/list-filters)”, I don’t see the identifier to use for migrated app events in the UNIFIED\_EVENTS eventTypeId field of the Lists API. I’ll make sure to pass this along internally.

Let’s consult our Top Experts: Hi @zach_threadint, @MichaelMa and @Anton do you have suggestions or workarounds to help @yoLotus, please?

Thanks so much and have a lovely day!  
Bérangère

---

<div class="post-metadata">

**Author:** ![zach\_threadint](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/zach_threadint/32/46318_2.png) [@zach\_threadint](https://community.hubspot.com/u/zach_threadint)\
**Post date:** [June 17, 2026, 1:23am UTC](https://community.hubspot.com/t/use-segments-lists-api-and-app-events/150439/5 "2026-06-17T01:23:19Z")

</div>

Hi @yoLotus 👋

Which HubSpot API endpoint are you calling? Assuming you are using the 2026-03 version, [here’s the official documentation](https://developers.hubspot.com/docs/api-reference/latest/crm/lists/create-list). According to that documentation, your request body shape looks a bit off. Here’s the example shape provided in the documentation:

```json
{
  "name": "<string>",
  "objectTypeId": "<string>",
  "processingType": "<string>",
  "customProperties": {},
  "filterBranch": {
    "filterBranchOperator": "<string>",
    "filterBranchType": "OR",
    "filterBranches": [
      {
        "filterBranchOperator": "<string>",
        "filterBranchType": "AND",
        "filterBranches": "<array>",
        "filters": [
          {
            "filterType": "PROPERTY",
            "operation": {
              "includeObjectsWithNoValueSet": true,
              "operationType": "BOOL",
              "operator": "<string>",
              "value": true
            },
            "property": "<string>"
          }
        ]
      }
    ],
    "filters": [
      {
        "filterType": "PROPERTY",
        "operation": {
          "includeObjectsWithNoValueSet": true,
          "operationType": "BOOL",
          "operator": "<string>",
          "value": true
        },
        "property": "<string>"
      }
    ]
  },
  "listFolderId": 123,
  "membershipSettings": {
    "includeUnassigned": true,
    "membershipTeamId": 123
  }
}

```

At the very least, it looks like you’re missing the top-level required keys:

- `name`
- `objectTypeId`
- `processingType`

Try reformatting your request body to fit this templated example and let us know how you get on. I hope this proves helpful. Please let me know if you have any follow-up questions.

---

<div class="post-metadata">

**Author:** ![yoLotus](https://avatars.discourse-cdn.com/v4/letter/y/e99b99/32.png) [@yoLotus](https://community.hubspot.com/u/yoLotus)\
**Post date:** [June 17, 2026, 10:18am UTC](https://community.hubspot.com/t/use-segments-lists-api-and-app-events/150439/6 "2026-06-17T10:18:04Z")

</div>

Hey @zach_threadint

Thanks for taking a look at this. You’re right, I was only sharing the filters part of my payload because I thought that was the relevant piece for the issue I was facing. Here is the full payload for more context (sorry in advance if the indentation is once again odd, I’m trying to use the formatting tool though):

```json
{

  "objectTypeId": "0-1",

"processingType": "DYNAMIC",

"listFolderId": 0,

"name": "List Name",

"filterBranch": {

"filterBranchType": "OR",

"filterBranchOperator": "OR",

"filters": [],

"filterBranches": [

      {

"filterBranchType": "AND",

"filterBranchOperator": "AND",

"filters": [],

"filterBranches": [

          {

"filterBranchType": "UNIFIED_EVENTS",

"filterBranchOperator": "AND",

"filterBranches": [],

"eventTypeId": "<app-id>_integrators-timeline-event-type-id-<event-id>",

"operator": "HAS_COMPLETED",

"filters": [

              {

"filterType": "PROPERTY",

"property": "myProperty",

"operation": {

"operationType": "STRING",

"operator": "IS_EQUAL_TO",

"value": "<given-value>"

                }

              }

            ]

          }

        ]

      }

    ]

  }

}

```

However, the issue is still the same: I’m not able to create a list using occurrences of the new app events as filters.

As mentioned by @Berangere , maybe this functionality is not fully documented or supported yet? To provide more context, I’m currently trying to migrate an existing list creation flow that was based on _timeline events_ over to the new _app events_ system.

---

<div class="post-metadata">

**Author:** ![zach\_threadint](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/zach_threadint/32/46318_2.png) [@zach\_threadint](https://community.hubspot.com/u/zach_threadint)\
**Post date:** [June 18, 2026, 1:08am UTC](https://community.hubspot.com/t/use-segments-lists-api-and-app-events/150439/7 "2026-06-18T01:08:41Z")

</div>

Hi @yoLotus 👋

I managed to make a little progress here.

I started by creating a List via the UI, referencing an App Event. I then [retrieved that List via API](https://developers.hubspot.com/docs/api-reference/latest/crm/lists/get-list-listId) (including query parameter `includeFilters` set to `true`), which revealed the App Event’s `eventTypeId`. This can be used when creating a List via API (i.e. not the App Event’s `fullyQualifiedName`, at least not currently).

However, I hit a snag when trying to set additional filters referencing App Event properties (even though I had no trouble adding them when creating a List via the UI). Here’s the error message I get when trying to include these filters on a create List API call:

```json
{
    "status": "error",
    "message": "The following properties are not available as filters for unified event ae12345_integrators-timeline-event-type-id-9876543210: ue_property_name.",
    "correlationId": "xxxx-xxxx-xxxx",
    "context": {
        "eventTypeFqn": [
            "ae12345_integrators-timeline-event-type-id-9876543210"
        ],
        "invalidPropertyNames": [
            "ue_property_name"
        ]
    },
    "category": "VALIDATION_ERROR",
    "subCategory": "ListError.UNIFIED_EVENT_PROPERTIES_NOT_FILTERABLE"
}

```

Worth noting that the App Event property names seem to be prepended with `ue_`.

I hope that proves helpful. Please let me know if you have any follow-up questions.

---

<div class="post-metadata">

**Author:** ![system](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/system/32/124_2.png) [@system](https://community.hubspot.com/u/system)\
**Post date:** [June 19, 2026, 2:00pm UTC](https://community.hubspot.com/t/use-segments-lists-api-and-app-events/150439/8 "2026-06-19T14:00:42Z")

</div>

Automatically bumped on June 19, 2026, 2:00pm UTC