Skip to main content

​
Common Error Messages

Quick reference for error messages you might see and how to fix them.

​
Authentication Errors

​
”HubSpot not connected”

What it means: No HubSpot account connected to Agent.AI Fix:
  1. Go to Settings → Integrations
  2. Click Connect HubSpot
  3. Authorize permissions
  4. Try workflow again

​
”Invalid credentials” or “Token expired”

What it means: HubSpot connection needs refresh Fix:
  1. Go to Settings → Integrations
  2. Disconnect HubSpot
  3. Reconnect HubSpot
  4. Run workflow again

​
”Insufficient permissions” or “Missing scope”

What it means: Missing required HubSpot permission Example: “This action requires crm.objects.contacts.write scope” Fix:
  1. Reconnect HubSpot
  2. Grant additional permissions when prompted
  3. Make sure to check all needed scopes
See: OAuth Scopes Reference

​
Object Not Found Errors

​
”Object not found” or “Record does not exist”

What it means: HubSpot ID doesn’t exist Common causes:
  • Wrong object ID
  • Object was deleted
  • Using test ID that doesn’t exist
Fix:
  1. Check object ID in execution log
  2. Verify object exists in HubSpot
  3. Use Search action first to get valid IDs
  4. Check variable is correct

​
”Contact not found with email”

What it means: No contact with that email address Fix:
  1. Verify email address is correct
  2. Check contact exists in HubSpot
  3. Try lookup by object ID instead
  4. Use Search action to find contact first

​
”Company not found with domain”

What it means: No company with that domain Fix:
  1. Verify domain format (example.com, not www.example.com)
  2. Check company exists in HubSpot
  3. Try lookup by object ID instead
  4. Use Search action to find company first

​
Variable Errors

​
”Variable not found” or “Undefined variable”

What it means: Referencing variable that doesn’t exist Common causes:
  • Action that creates variable failed
  • Typo in variable name
  • Variable only exists inside loop/if block
Fix:
  1. Check action order - variable must be created first
  2. Verify variable name spelling
  3. Check execution log - did creating action succeed?
  4. If inside loop, variable only exists inside loop

​
”Cannot access property of undefined”

What it means: Trying to access property on empty/null variable Example: {{contact.properties.email}} when contact is null Fix:
  1. Add If Condition to check variable exists first
  2. Check execution log - what did previous action return?
  3. Verify property path is correct
  4. Make sure previous action succeeded

​
Search/Lookup Errors

​
”No results found”

What it means: Search returned empty (not an error, just no matches) Fix:
  1. Check search filters - too restrictive?
  2. Verify data exists in HubSpot
  3. Try simpler search first
  4. Add If Condition to handle empty results

​
”Invalid filter operator”

What it means: Using wrong operator for property type Example: Using “Greater Than” on text field Fix:
  1. Text fields: Use “Equals”, “Contains”, “Starts With”
  2. Numbers: Use “Greater Than”, “Less Than”, “Equals”
  3. Dates: Use “Greater Than”, “Less Than” (as timestamps)
  4. Check property type in HubSpot

​
”Property does not exist”

What it means: HubSpot property doesn’t exist Common causes:
  • Typo in property name
  • Custom property not created
  • Using wrong object type
Fix:
  1. Verify property exists in HubSpot settings
  2. Use exact internal name (lowercase, underscores)
  3. Check object type matches (contact vs. deal vs. company)
  4. Use property picker (+ Add Property button)

​
Update Errors

​
”Cannot update property”

What it means: Property is read-only or doesn’t exist Common causes:
  • System property (can’t be modified)
  • Property doesn’t exist
  • Wrong permissions
Fix:
  1. Check if property is system-managed
  2. Verify property exists and is editable
  3. Grant write permissions for object type
  4. Try different property

​
”Invalid property value”

What it means: Value doesn’t match property type Example: Setting text in number field Fix:
  1. Check property type in HubSpot
  2. Text properties: Any value
  3. Number properties: Numbers only (no commas, letters)
  4. Date properties: ISO format or timestamp
  5. Dropdown properties: Use exact option value

​
Timeline Event Errors

​
”Invalid event type”

What it means: Event type name invalid or doesn’t exist Fix:
  1. Use lowercase with underscores: onboarding_completed
  2. No spaces or special characters
  3. Create event type in HubSpot settings first (if custom)
  4. System event types: lowercase

​
”Timeline events not available”

What it means: HubSpot tier doesn’t support custom timeline events Fix:
  1. Upgrade to Professional or Enterprise
  2. Use notes/engagements instead
  3. Check HubSpot feature availability

​
Engagement Errors

​
”Associations are required”

What it means: Creating engagement without associating to a record Fix:
  1. Add associations field
  2. Format: contact:{{contact_id}}
  3. At least one association required
  4. Use valid HubSpot object ID

​
”Invalid engagement type”

What it means: Engagement type not recognized Fix:
  1. Use: note, call, email, meeting, or task
  2. Lowercase only
  3. No plural (use note not notes)

​
“Invalid duration format”

What it means: Duration not a number Fix:
  1. Use minutes as number: 30 (not “30 minutes”)
  2. Must be numeric value
  3. Applies to calls and meetings only

​
Loop/Condition Errors

​
”Loop variable not found”

What it means: Trying to use loop variable outside loop Fix:
  1. Loop variables only exist inside loop
  2. Use loop variable between For Loop and End Loop
  3. Create new variable outside loop if needed after

​
”End Condition without matching start”

What it means: End Condition with no For Loop or If Condition before it Fix:
  1. Every End Condition needs a For Loop or If Condition
  2. Check action order
  3. Remove extra End Condition

​
”Missing End Condition”

What it means: For Loop or If Condition without End Condition Fix:
  1. Add End Condition action after loop/if block
  2. Every For Loop needs End Loop
  3. Every If Condition needs End Condition

​
Webhook Errors

​
”Webhook payload empty”

What it means: Webhook received but no data Fix:
  1. Check HubSpot workflow sends payload
  2. Verify JSON format in HubSpot
  3. Test HubSpot workflow
  4. Check webhook URL is correct

​
”Portal ID missing”

What it means: _hubspot_portal not in webhook payload Fix:
  1. Add to HubSpot webhook payload: "_hubspot_portal": "{{portal.id}}"
  2. Required for HubSpot actions
  3. Always include in webhook

​
Rate Limit Errors

​
”Rate limit exceeded”

What it means: Too many API calls to HubSpot Fix:
  1. Add delays between actions in loops
  2. Reduce batch sizes
  3. Wait and retry
  4. HubSpot has daily API limits

​
General Errors

​
”Invalid JSON”

What it means: JSON syntax error in input Fix:
  1. Check JSON format (matching braces, quotes)
  2. Use JSON validator
  3. Common: Missing comma, extra comma, mismatched quotes

​
”Timeout”

What it means: Action took too long Fix:
  1. Simplify action (fewer filters, smaller result set)
  2. Check HubSpot availability
  3. Try again (temporary issue)

​
“Unknown error”

What it means: Unexpected error Fix:
  1. Check execution log for details
  2. Verify all inputs are valid
  3. Try simpler version of action
  4. Contact support with execution log

​
Debugging Tips

When you hit an error:
  1. Check execution log
    • See exact error message
    • View variable values
    • See what action failed
  2. Simplify and test
    • Remove variables, use hardcoded values
    • Test with known-good data
    • Isolate the failing action
  3. Verify data exists
    • Check object exists in HubSpot
    • Verify property names are correct
    • Confirm permissions granted
  4. Test in HubSpot first
    • Can you see the object in HubSpot?
    • Can you manually update it?
    • Does the property exist?
Guides: Foundation:
Last Updated: 2025-10-01