HubSpot Commerce Hub provides invoices and payment links as CRM objects; create an invoice via POST https://api.hubapi.com/crm/v3/objects/invoices with properties such as 'hs_invoice_status', due date, and currency (verify current required properties against HubSpot Commerce documentation).
Associate the invoice to a contact or company using the Associations API v4: POST https://api.hubapi.com/crm/v4/objects/invoices/{invoiceId}/associations/default/contacts/{contactId}.
Add line items to the invoice by creating line item records and associating them to the invoice, similar to the quote flow.
To collect payment, create a payment link via POST https://api.hubapi.com/payments/v1/payment-links (verify the current endpoint path against HubSpot Commerce docs) with the relevant line items and settings.
Monitor payment status by querying the payments object or subscribing to HubSpot webhook events for payment completion notifications.
Retrieve invoice records: GET https://api.hubapi.com/crm/v3/objects/invoices/{invoiceId} with associations as needed.
Known gotchas
HubSpot Commerce Hub features (invoices, payment links, native payments) require specific HubSpot subscription tiers and are only available in certain regions; verify availability for your account before building integrations.
Payment processing via HubSpot's native payments is powered by Stripe under the hood and requires onboarding setup in the HubSpot account; the API alone does not enable payments without this setup.
Invoice and payment endpoint paths are subject to change as HubSpot Commerce Hub matures; always verify the current API reference rather than relying on cached documentation.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp