## TL;DR

The association spec in the request is malformed: wrong association type or bad object IDs. Check the association definition against the docs and fix the spec.

## Error

```text
hubspot error: ASSOCIATION_SPEC_INVALID
```

## Steps

1. Log the association spec being sent Expected: you see the malformed part.
2. Check the association type ID against the docs Expected: it is valid.
3. Fix the from/to object IDs Expected: they exist and are the right types.
4. Re-run the request Expected: it succeeds.

## When to use

- HubSpot ASSOCIATION_SPEC_INVALID
- The association definition is wrong

## When not to use

- The spec looks right (then check the object IDs)
- Associations worked before (then check for API changes)

## Tool compatibility

- HubSpot associations API
- CRM sync jobs

## Variant phrasings

### association_spec_invalid

The association type or object IDs are wrong.

### hubspot association invalid

Same: validate the spec against the docs.

## Why it happens

Association specs have three moving parts (type, from, to) and the error does not say which is wrong. Agents guess.

## Edge cases

- Association labels vs type IDs: use the right one
- Some associations are directional

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_61dd6_Cy3wyq3VfSaQLYkg