topic Re: Label Associations: POST /crm/v4/associations/{from}/{to}/labels returns 500 in APIs & Integrations

Label Associations: POST /crm/v4/associations/{from}/{to}/labels returns 500

EdoardoP — Thu, 22 Jan 2026 08:22:23 GMT

Hey everyone,

I am trying to create custom association labels between a custom object and the Lead object via the v4 API, and I keep getting a 500 internal error.

Here's what I'm doing:

POST https://api.hubapi.com/crm/v4/associations/2-197105422/lead/labels

Body:

{
  "name": "manual_lead_to_edition",
  "label": "Manual",
  "inverseLabel": "Manual"
}

Response:

{
  "status": "error",
  "message": "internal error",
  "correlationId": "b89fd04f-15e4-4cb2-a4c8-efec04f8078d"
}

I've checked the docs (https://developers.hubspot.com/docs/api-reference/crm-associations-schema-v4/definitions/post-crm-associations-v4-fromObjectType-toObjectType-labels) and my request matches exactly what's expected. Required fields are there, JSON is valid, token works fine on every other endpoint.

What I've already tried:
- Different label names
- Removing inverseLabel entirely
- Using the fully qualified object name instead of the object type ID
- Verified the token works (other API calls are fine)
- GET on the same endpoint returns an empty results array, so the path is valid

Creating default associations (without labels) works perfectly. It's only when I try to create a labeled association that it blows up.

My gut says this might be a Lead object thing? Lead is still relatively new and maybe the v4 associations schema doesn't fully support it yet? Or is there some undocumented requirement I'm missing?

I have already submitted a feedback to HubSpot but figured I'd check here too in case someone has run into this or knows a workaround.

Thanks for any pointers.

Re: Label Associations: POST /crm/v4/associations/{from}/{to}/labels returns 500

BérangèreL — Thu, 22 Jan 2026 10:45:08 GMT

Hi @EdoardoP and thanks for laying out all those details. You’re correct that the Lead object is relatively new to HubSpot, and some endpoints (including associations with custom labels) may not have full support yet.

As you’ve already checked the docs and submitted feedback, I’d recommend keeping an eye on HubSpot’s changelog for any new enhancements around Lead associations.

Let's invite our Top Experts to this conversation: Hi @Anton, @MichaelMa and @Christensen can you think of a workaround to help @EdoardoP, please?

Appreciate you bringing this up for discussion, it’ll definitely help others who run into the same roadblock.

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

Re: Label Associations: POST /crm/v4/associations/{from}/{to}/labels returns 500

EdoardoP — Thu, 22 Jan 2026 10:50:38 GMT

I missed a crucial detail in my post: creating labelled associations between my custom object and Lead object works fine using the UI.

Re: Label Associations: POST /crm/v4/associations/{from}/{to}/labels returns 500

MichaelMa — Thu, 22 Jan 2026 13:21:30 GMT

Maybe a bug in the API?

The label and inverseLabel cannot be the same value when trying to create a label via the API. Likely because if they are the same, you just need the label field instead of both.

Re: Label Associations: POST /crm/v4/associations/{from}/{to}/labels returns 500

EdoardoP — Thu, 22 Jan 2026 15:07:03 GMT

Thank you, I completely missed the fact that inverseLabel is not a required field.

That Internal Server Error was indeed very likely due to label and inverseLabel being the same. Passing just label returns 200.