hubspot-create-meeting

name	hubspot-create-meeting
description	Create a meeting engagement in HubSpot CRM. Load when user says 'create meeting', 'add meeting', 'schedule meeting', 'new meeting'. Requires title, start and end times.

Create HubSpot Meeting

Specialized skill for creating meeting engagements in HubSpot CRM.

Pre-Flight Check

Before running, execute config check:

python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json

If ai_action is not proceed_with_operation, follow hubspot-connect setup guide.

---

Usage

Required Parameters

• --title - Meeting title (required)

Optional Parameters

• --body - Meeting description/notes
• --start - Start time in ISO format (defaults to now)
• --end - End time in ISO format (defaults to start + 1 hour)

Examples

Meeting with times:

python 00-system/skills/hubspot/hubspot-master/scripts/create_meeting.py \
  --title "Product Demo" \
  --body "Demo of new features for enterprise team" \
  --start "2025-12-15T14:00:00Z" \
  --end "2025-12-15T15:00:00Z" \
  --json

Quick meeting (defaults to now + 1 hour):

python 00-system/skills/hubspot/hubspot-master/scripts/create_meeting.py \
  --title "Quick sync call" \
  --json

---

Output Format

{
  "id": "14771947458",
  "properties": {
    "hs_meeting_title": "Product Demo",
    "hs_meeting_body": "Demo of new features...",
    "hs_meeting_start_time": "2025-12-15T14:00:00Z",
    "hs_meeting_end_time": "2025-12-15T15:00:00Z",
    "hs_timestamp": "2025-12-15T14:00:00Z"
  }
}

---

Display Format

✅ Meeting created!
  ID: 14771947458
  Title: Product Demo
  Start: 2025-12-15 14:00
  End: 2025-12-15 15:00
  Duration: 1 hour
  Notes: Demo of new features for enterprise team

---

Time Format

Use ISO 8601 format for times:

• 2025-12-15T14:00:00Z (UTC)
• 2025-12-15T14:00:00+01:00 (with timezone)

---

Error Handling

Error	Solution
401	Invalid token - re-run setup
403	Missing crm.objects.meetings.write scope
400	Invalid time format
429	Rate limited - wait and retry

---

Related Skills

• hubspot-list-meetings - List all meetings
• hubspot-get-associations - Link meeting to contacts