Add a note to a HubSpot contact
Input
note requiredThe note text. Plain text.
contactId requiredThe contact's HubSpot id, as returned by the contact search (or create_or_update_contact).
dry_run optionalWhen true the note is typed into the composer and the run stops before saving it. Nothing is added.
Default: falseportalId optionalThe HubSpot account id, when the login has more than one. Omit it to use the default account.
Output
dryRun requiredposted requiredTrue only when a new note with this text was read back from the contact's timeline after a reload.
portalId requiredcontactId requiredurl optionalnoteId optionalHubSpot engagement id of the new note.
accountUsed optionalalreadyPresent optionalWhether a note with the same text was already on the contact before this run (among the latest 20 timeline items). The run still adds a new one; the caller decides whether that is a duplicate.
FAQ
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.