Create or update a HubSpot contact
Input
email requiredThe contact's email address. This is the key: an address already on the account is updated rather than duplicated.
dry_run optionalWhen true, works out whether the contact exists and fills the form, then stops before saving. Nothing is created or changed.
Default: falselastName optionalportalId optionalThe HubSpot account id, when the login has more than one. Omit it to use the default account.
firstName optionallegalBasis optionalGDPR legal basis for processing the contact's data, used when creating. Required on accounts with GDPR features on (HubSpot will not create the contact without it); ignored for an existing contact. Never defaulted — the caller must choose it.
Output
email requiredsaved requiredTrue only when a save happened AND the contact was re-read with the requested values.
action requiredcreated / updated = saved and confirmed; unchanged = the contact exists and already has these values, so nothing was saved; would_* = dry run.
dryRun requiredportalId requiredchanged optionalWhich fields were changed on an existing contact.
contactId optionalcontactUrl optionalaccountUsed optionalexistedBefore optionalFAQ
HubSpot login (Google SSO)
Log into HubSpot (app.hubspot.com) with Google SSO: submits your email, signs in through Google, and handles the account chooser and first-time consent. HubSpot then shows a new-device email-verification step: pass the 6-digit code as `code`, or sign in once manually so HubSpot trusts the device — that confirmation is reliable only on a trusted device, so in practice this re-logs you in after one manual sign-in. `email` is required for a fresh sign-in: HubSpot's login is identifier-first, so the Google option only appears once an email is submitted, and it also selects which Google account to use.
List HubSpot invoices
List the billing invoices on a HubSpot account, taken from Account & Billing → Transactions: each invoice's number, date, amount, status, and a link to its PDF. The PDF link is tied to the signed-in session, so it only opens while that session is still active. Sign in to HubSpot in the browser this runs against before using it — signed out, the script says so rather than returning an empty list. Pass portalId to target a specific portal when the account has more than one.
Search HubSpot contacts
Search the contacts in a HubSpot account and return the matching rows with name, email, phone, owner, company and dates. Finds the right account and region automatically, and reports a search that matches nothing as an empty result.