Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mycelium-ai.co/llms.txt

Use this file to discover all available pages before exploring further.

HubSpot uses a webhook receiver (paid runtime).

​
Webhook receiver (paid runtime)

POST /webhooks/hubspot/{tenant_id}
Signature: HubSpot signs payloads with X-HubSpot-Signature (HMAC-SHA256 of {client_secret}{http_body}). The receiver validates the HMAC against the per-tenant client secret.

​
Setup

  1. In HubSpot, go to Settings > Integrations > Private Apps (or create a public app for OAuth).
  2. Create a private app with scopes: crm.objects.contacts.read, crm.objects.deals.read, crm.objects.companies.read, timeline.
  3. In the app’s Webhooks settings, add a webhook subscription for https://runtime.myceliumai.co/webhooks/hubspot/{your_tenant_id}.
  4. Subscribe to events: Contact Created, Deal Stage Changed, Company Created, Timeline Event Created.
  5. Add to the runtime env:
    • HUBSPOT_CLIENT_SECRET_{TENANT_ID} (for signature validation)
    • HUBSPOT_APP_ID_{TENANT_ID}

​
Events ingested

HubSpot eventMemory categoryNotes
Contact createdrelationshipName, email, company, source
Deal stage changeddecisionStage progression captured as decision
Deal closed-wondecisionAmount, close date, associated contacts
Deal closed-lostexceptionReason captured if populated
Company createdrelationshipCompany profile and initial properties
Timeline eventfactCustom timeline events

​
Retry behavior

Failed deliveries land in the per-tenant dead-letter folder. Replay via: 
POST /admin/webhooks/replay/{tenant_id}/{event_id}