hubspot-core-workflow-a

# HubSpot Core Workflow A: Contact-to-Deal Pipeline ## Overview End-to-end workflow: capture a lead, create/update contact, create company, create deal in pipeline, advance deal stages, and log activities. The primary money-path workflow for HubSpot CRM. ## Prerequisites - Completed `hubspot-install-auth` setup - Scopes: `crm.objects.contacts.write`, `crm.objects.companies.write`, `crm.objects.deals.write` - Understanding of your HubSpot deal pipeline and stages ## Instructions ### Step 1: Capture and Upsert Contact ```typescript import * as hubspot from '@hubspot/api-client'; const client = new hubspot.Client({ accessToken: process.env.HUBSPOT_ACCESS_TOKEN!, numberOfApiCallRetries: 3, }); interface LeadInput { email: string; firstName: string; lastName: string; company: string; phone?: string; source?: string; } async function upsertContact(lead: LeadInput): Promise<string> { // Search for existing contact by email // POST /crm/v3/objects/contacts/search const existing = await client.crm.contacts.searchApi.doSearch({ filterGroups: [{ filters: [{ propertyName: 'email', operator: 'EQ', value: lead.email }], }], properties: ['firstname', 'lastname', 'email'], limit: 1, after: 0, sorts: [], }); if (existing.results.length > 0) { // Update existing contact const contactId = existing.results[0].id; await client.crm.contacts.basicApi.update(contactId, { properties: { firstname: lead.firstNa...