Hi,
I’m trying to create an email with associations via the API.
My POST to https://api.hubapi.com/crm/v3/objects/emails:
{
"properties": {
"hs_email_subject": "Hello",
"hs_email_text": "Test1",
"hs_timestamp": "2025-10-02T18:00:01+01:00",
"hs_email_direction": "EMAIL",
"hs_email_status": "SENT"
},
"associations": [
{
"to": {
"id": 466992278730
},
"types": [
{
"associationCategory": "HUBSPOT_DEFINED",
"associationTypeId": 198
}
]
}
]
}
yields the following response:
{
"status": "error",
"message": "one or more associations are not valid",
"correlationId": "1008940b-2d9d-4074-902b-391d8ce2aac9",
"errors": [
{
"context": {
"validationResult": [
"USER_DOES_NOT_HAVE_PERMISSIONS"
]
}
}
],
"category": "BAD_REQUEST"
}
If I remove the association property, the Hubspot API reports back that the email was created.
Using the following scopes:
"oauth",
"crm.objects.contacts.read",
"crm.objects.contacts.write",
"crm.objects.companies.read",
"crm.objects.companies.write",
"crm.objects.deals.read",
"crm.objects.deals.write"
I am able to successfully create contacts with associations using the payload below to https://api.hubapi.com/crm/v3/objects/contacts so associations work, just not when doing from email to contact.
{
"properties": {
"email": "someone@example.com",
"firstname": "John",
"lastname": "Doe"
},
"associations": [
{
"to": {
"id": 238323633387
},
"types": [
{
"associationCategory": "HUBSPOT_DEFINED",
"associationTypeId": 279
}
]
}
]
}
Does anyone have a suggestion? Thank you!
Edit: solution found, apparently the legacy association ids work: Accounts Dashboard | HubSpot
For emails it’s the “Engagement to …” that work.