Search HubSpot contacts
Input
query requiredText to search contacts for — a name, an email, or part of either. Pass an empty string to list without filtering.
portalId optionalThe HubSpot account id to read, when the login has more than one. Omit it to use the default account, or the only one.
Output
query requiredcontacts requiredportalId requiredThe HubSpot account the contacts were read from.
url optionalcolumns optionalThe contact table's column headings, in the account's own interface language. A named field below is filled only where its heading appears here.
matched optionalWhether the search returned any contacts at all. False means HubSpot reported the search as empty, which is an answer rather than a failure.
accountName optionalcontactCount 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.