hubspot-create-meeting_skill

Overview

This skill creates a meeting engagement in HubSpot CRM from the command line. It requires a meeting title and accepts start/end times, with sensible defaults if times are omitted. Use it to record demos, calls, or internal syncs quickly in HubSpot. It returns the created meeting ID and key properties in JSON for further automation.

How this skill works

Before running, the skill checks HubSpot configuration and connection status; if the pre-flight check fails it instructs you to complete hubspot-connect setup. The script requires --title and accepts --start and --end in ISO 8601 format; if start is omitted it uses now, and if end is omitted it defaults to start + 1 hour. On success it outputs a JSON object with id and properties and prints a compact summary including start, end, duration and notes.

When to use it

• Record a scheduled demo or client call directly into HubSpot
• Quickly log an internal sync or standup without opening the UI
• Automate meeting creation from scripts or CI workflows
• Create meetings programmatically when onboarding customers
• Add meetings as part of a multi-step sales automation

Best practices

• Run the provided config check before creating meetings to ensure tokens and scopes are valid
• Provide start and end times in ISO 8601 with timezone to avoid ambiguity
• Include a concise --body to capture agenda or key notes for follow-ups
• Handle API errors: re-authenticate on 401, add crm.objects.meetings.write scope for 403, and back off on 429
• Use the JSON output for chaining into other automation or to store the meeting ID

Example use cases

• Create a product demo meeting: specify title, body, start and end in ISO format
• Quick sync: run the script with --title only to create a meeting now + 1 hour
• CI-triggered meeting: generate a post-deployment check-in meeting automatically
• Onboarding flow: script creates a kickoff meeting and attaches it to a contact via follow-up scripts