## TL;DR

The HubSpot object ID does not exist (or is in a different portal). Verify the ID and the account.

## Error

```text
HubSpot error: OBJECT_NOT_FOUND
```

## Steps

1. Verify the object ID is correct Expected: no typo or truncation.
2. Confirm you are hitting the right HubSpot account Expected: no portal mixup.
3. Check whether the object was deleted or merged Expected: you know its fate.
4. Point the call at the surviving object Expected: it succeeds.

## When to use

- HubSpot OBJECT_NOT_FOUND
- The ID is wrong or the object is gone

## When not to use

- The object exists (then check private app scopes)
- Recently deleted (then it may be unrecoverable)

## Tool compatibility

- HubSpot object IDs
- CRM sync jobs

## Variant phrasings

### hubspot object_not_found

Verify the ID and the portal. The object may be deleted or merged.

### OBJECT_NOT_FOUND hubspot

Same: check the ID and account.

## Why it happens

Agents cache IDs across runs; deletes and merges invalidate the cache silently.

## Edge cases

- Merged objects keep the winner's ID; update your references
- Test vs production portals have different IDs

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_iH0vMlH-CkyClK9g-jcBZA