Skip to content
Esc
  • OverviewGuidesWhat exists today, and where to start.
  • QuickstartGuidesKey, domain, first send — in that order.
  • AuthenticationGuidesBearer keys, the mandatory User-Agent, and what each refusal means.
  • ErrorsGuidesThe whole vocabulary, with the status each name carries.
  • IdempotencyGuidesRetry a send without sending it twice.
  • PaginationGuidesCursors are item IDs, not page numbers.
  • Rate limitsGuidesTen a second per team, and the headers that tell you where you are.
  • Sending newslettersGuidesUse a campaign, or include an unsubscribe link.
  • EventsGuidesEvery event a webhook can carry, with one real payload each.
  • DomainsGuidesThe records, where they go at each registrar, and what the page does while you wait.
  • Address verificationGuidesDon't send to addresses that don't exist, and verify a list before you mail it.
  • TrackingGuidesOpens and clicks: one record, two toggles, and what an open really means.
  • Sign-up formsGuidesPop-ups and embedded forms on your site, and the rules that pick one.
  • Website trackingGuidesrasket.js on your own site: the snippet, consent, three events and the check.
  • TemplatesGuidesFifty-seven starters sorted by goal, and how to keep a campaign as a template.
  • ReceivingGuidesInbound mail, and the Inbox: a webhook fires, you read it, you answer it.
  • InboxGuidesChannels, personal mailboxes and seats: who sees what, and where a reply goes.
  • Mail appsGuidesComing soon: your Rasket address in Apple Mail, Outlook and the Gmail app.
  • Inbox APIGuidesOpen, read and answer support conversations from your app, with the same key.
  • Support inbox in your appGuidesA Contact us form that opens a conversation your team answers, in five minutes.
  • Replies to your emailsGuidesOne field on a send, and the customer's reply opens a conversation.
  • Let an agent triageGuidesAn AI agent reads, notes and drafts over MCP; a person sends.
  • Node SDKGuidesThe rasket package: typed from the API's own document, retries only what is safe.
  • Python SDKGuidesThe rasket package on PyPI: the Node client's methods, in snake_case, over httpx.
  • MCP serverGuidesConnect Claude, ChatGPT or any MCP client: your scopes, no key.
  • AI assistGuidesSubject lines, drafts and diagnosis — in the dashboard and over the API, off until you allow it.
  • AgentsGuidesLet an AI agent set Rasket up: the skill, the rules file, MCP, and the recipe they share.
  • OAuthGuidesLet another app act for a team: register, authorize with PKCE, exchange, refresh.
  • Single sign-onGuidesOIDC login for your team, a domain proved by DNS, enforcement and break-glass.
  • IntegrationsGuidesEvery integration and its status, and Rasket on Vercel, Netlify and Cloudflare.
  • SMTPGuidesSend from anything that speaks SMTP: settings, setup guides, limits and replies.
  • ZapierGuidesSend email, add contacts and react to email events from a Zap, with no code.
  • n8nGuidesComing soon: the Rasket node and trigger for n8n workflows.
  • VercelGuidesAdd Rasket on Vercel: a Sending key in each project as RASKET_API_KEY, no copying.
  • WordPressGuidesComing soon: the Rasket plugin, sending every email your site sends.
  • NotionGuidesTurn a Notion database of people into contacts in a segment, once or every hour.
  • Migrating to RasketGuidesBring contacts, unsubscribes, lists and templates from Mailchimp, Klaviyo and more.
  • PipedreamGuidesComing soon: Rasket actions and instant sources for Pipedream workflows.
  • FramerGuidesComing soon: the Rasket plugin for sign-up forms on a Framer site.
  • MakeGuidesComing soon: send email and react to email events from a Make scenario.
  • monday.comGuidesComing soon: turn monday.com board items into contacts.
  • ClickUpGuidesComing soon: ready-made Zapier and Make automations for ClickUp tasks.
  • HubSpotGuidesComing soon: keep HubSpot contacts and lists in step with Rasket.
  • WebflowGuidesComing soon: Webflow form submissions as contacts, orders as store events.
  • WixGuidesComing soon: Wix contacts, carts and orders as store flows.
  • SlackGuidesComing soon: email alerts in the Slack channels you choose.
  • Google SheetsGuidesComing soon: turn a sheet tab of people into contacts in a segment.
  • AirtableGuidesComing soon: turn an Airtable table of people into contacts in a segment.
  • ShopifyGuidesComing soon: Rasket for Shopify, with customers, store events and flows.
  • SMS quickstartGuidesSend your first text to a US or Canadian phone.
  • Get a numberGuidesToll-free or local numbers, and the registration carriers require.
  • Consent and STOPGuidesWho you may text, the proof you keep, and replies like STOP.
  • SMS campaignsGuidesText a segment, at a local time, priced before you send.
  • Texts in automationsGuidesThe Send SMS step, and what happens to a contact without a phone.
  • SMS webhooksGuidesThe six sms events and what each one carries.
  • SMS pricingGuidesTexts included in each plan, the price per message, and number fees.
  • EmailsAPI referenceSend, batch, retrieve, list, reschedule, cancel, attachments.
  • DomainsAPI referenceAdd a domain, publish its records, verify it.
  • API keysAPI referenceCreate, list, rename and revoke credentials.
  • WebhooksAPI referencePayloads, signature verification, retries and replay.
  • SuppressionsAPI referenceAddresses we will not send to, and why.
  • LogsAPI referenceEvery request made with this team's credentials.
  • MetricsAPI referenceDelivery, bounce, complaint and engagement counts.
  • TemplatesAPI referenceVersioned email content with typed variables, addressed by ID or alias.
  • ContactsAPI referenceYour audience: contacts, their typed properties, segments and topic choices.
  • SegmentsAPI referenceAudiences defined by a filter, by hand, or both.
  • TopicsAPI referenceWhat contacts subscribe to, and the preference page's list.
  • CampaignsAPI referenceCampaigns, at /broadcasts: one message to a segment, from draft to results.
  • AutopilotAPI referenceStore campaigns Autopilot drafts for you, each waiting for a yes or a skip.
  • ImportsAPI referenceCSV uploads: column mapping, conflicts and counts.
  • AutomationsAPI referenceWorkflows that run per contact: the graph, its versions, and every run.
  • Custom eventsAPI referenceThe names your product fires, and what starts a workflow.
  • ReceivingAPI referenceMail sent to you: the message, its attachments, its raw source.
  • OAuthAPI referenceClient registration, the token endpoint, and the grants a team has given.
  • TeamAPI referenceThe team a credential belongs to: its plan, sender identity, AI flag and members.
  • BillingAPI referencePlan, usage, invoices and add-ons, and the hosted pages where a customer pays.
  • AI helpersAPI referenceSubject lines, a first draft, and why an email did what it did.
  • InboxAPI referenceChannels, conversations, messages, notes and search in your support inbox.
  • SMSAPI referenceSend, schedule and cancel texts, numbers, test phones and SMS consent.

GuidesHubSpot

HubSpot

Keep your HubSpot contacts and lists in step with Rasket. The lists you turn on become segments, unsubscribes reach both sides, and each HubSpot contact record shows the emails Rasket sent them.

Coming soon: connecting HubSpot is not switched on yet. This page describes it as it will ship. Until then, export your contacts from HubSpot as a CSV file and import them in Audience.

What it does

  • Lists become segments. Turn on a HubSpot list and its people become contacts in a segment. The segment stays in step as the list changes.
  • Contacts stay in step. Names, company and lifecycle stage come from HubSpot. Each contact's Rasket status and last open go back to HubSpot.
  • Unsubscribes count everywhere. Someone who unsubscribes in HubSpot or in Rasket gets no more campaigns from Rasket.
  • A card on the contact record. HubSpot shows the contact's Rasket status and their latest emails.
  • Reads only what it needs. Rasket reads contacts and lists. It writes two contact properties of its own, and never touches deals, tickets, files or other objects.

Before you start

  • An admin of the Rasket project. Connecting HubSpot and turning lists on are an admin's decisions. Other members can see the page but not change it.
  • A HubSpot super admin. You sign in to HubSpot as a super admin and choose the account.
  • A verified sending domain, for the campaigns you send afterwards. The domains guide walks through it.

Connect HubSpot

From Rasket

  1. In Rasket, open Settings, then Integrations, then HubSpot, and choose Connect HubSpot.
  2. Rasket says what it will read and write. Choose Continue to HubSpot.
  3. In HubSpot, sign in as a super admin, choose the account and approve Rasket.
  4. You are back on Settings with “HubSpot is connected.” Nothing syncs until you turn lists on.

From HubSpot's App Marketplace

  1. In HubSpot's App Marketplace, find Rasket and install it.
  2. Sign in to Rasket. Choose the Rasket project to connect.
  3. Choose Continue to HubSpot and approve Rasket in HubSpot once more.

Finish within ten minutes of choosing Continue. After that the connection expires and nothing is read; start again from Settings. One HubSpot account connects to one Rasket project.

Turn lists on

  1. Under Lists, find the HubSpot list and choose Turn on.
  2. Under Add them to the segment, pick an existing segment, or A new segment… and type its name.
  3. Under Who can be emailed, say what the list's people agreed to, as described below.
  4. Choose Turn on. The list joins its segment on the next sync, within a few minutes, or press Sync now.
  • They agreed to hear from you. They arrive subscribed. You also confirm that current and future members of the list agreed. Rasket keeps that statement, who made it and when.
  • Add them as never subscribed. They arrive as contacts who get transactional mail only. You cannot send them campaigns until they opt in.

Anyone already unsubscribed in HubSpot or in Rasket stays unsubscribed, whichever you choose. Turn off stops a list. Its segment and the people in it stay.

What syncs which way

What syncs which way
HubSpot propertyIn RasketDirection
EmailThe contact's email addressBoth ways. It is the key.
First nameFirst nameHubSpot → Rasket
Last nameLast nameHubSpot → Rasket
Company nameThe company propertyHubSpot → Rasket
Lifecycle stageThe lifecycle_stage propertyHubSpot → Rasket
Unsubscribed from emailThe contact's statusHubSpot → Rasket, unsubscribes only
Rasket subscription statusThe contact's statusRasket → HubSpot
Rasket last email openedThe last open, from email eventsRasket → HubSpot

The two Rasket → HubSpot fields are contact properties Rasket creates in a group named Rasket. HubSpot wins names, company and lifecycle stage. Rasket wins the subscription status. A contact is matched by its HubSpot record, so an email address changed in HubSpot moves with the contact.

  • An unsubscribe in either place wins. Unsubscribed from email in HubSpot means unsubscribed in Rasket. An unsubscribe in Rasket is written to the Rasket subscription status property, and also unsubscribes the person from email in HubSpot when the connection allows it. The Fields card in Settings says which.
  • HubSpot never re-subscribes anyone. A sync can lift a never-subscribed contact on a list whose people agreed. It never subscribes someone who unsubscribed.
  • A resubscribe in Rasket is not sent to HubSpot.
  • Suppressed addresses are never subscribed. The status property shows them as suppressed.
  • A contact deleted in Rasket stays deleted. The sync does not add it again.
  • A deletion in HubSpot never deletes the Rasket contact.
  • Leaving a HubSpot list removes the person from the segment only if the sync put them there. People you added to the segment yourself stay.

The card on the HubSpot contact record

Each HubSpot contact record gets a Rasket card. It shows the contact's status in Rasket, the topics they subscribe to and the last three emails Rasket sent them, with what happened to each. Open in Rasket opens the contact in Rasket. A contact that is not in a list you turned on shows “Not in Rasket yet”.

Email activity on the timeline

Rasket can put each email's sent, delivered, opened, clicked and bounced events, and each unsubscribe, on the HubSpot contact's timeline. HubSpot shows these once it approves the app for them, and Settings says “Waiting for HubSpot” until then. In the meantime the card shows the emails, and the two Rasket properties carry the status and the last open.

How often it syncs

  • Every 15 minutes, and within about five minutes of a change in HubSpot.
  • Sync now on Settings → Integrations → HubSpot runs it at once.
  • Recent syncs shows the newest runs and what each added, updated and sent to HubSpot. Rasket keeps the last 30.
  • Your plan's contact limit applies, as it does to an import.

Disconnect or uninstall

  • Disconnect in Rasket removes Rasket from the HubSpot account and revokes its access. The lists stop syncing.
  • Uninstalling Rasket in HubSpot pauses the sync. Settings says so and offers Reconnect, which picks up where it stopped.

Either way, the contacts and their segments stay in Rasket.

Troubleshooting

“The sync is paused”

HubSpot stopped accepting Rasket's access, usually because Rasket was uninstalled in HubSpot. Nothing is lost. Choose Reconnect and sign in as a HubSpot super admin; the sync picks up where it stopped.

“Paused: HubSpot no longer has this list.”

The list was deleted in HubSpot. Turn it off in Rasket. Its segment stays.

“Paused: its segment was deleted. Turn it on again with another segment.”

Turn the list off, then on again, and pick another segment or a new one.

“This HubSpot account is connected to another Rasket project”

One HubSpot account connects to one Rasket project. Disconnect it in the other project first, then connect it here.

“HubSpot isn't available here”

Connecting HubSpot is not switched on for this deployment. Export your contacts from HubSpot as a CSV file and import them in Audience instead.

“This connection has expired”

More than ten minutes passed. Nothing was read. Start again from Settings → Integrations → HubSpot.

“The request was cancelled in HubSpot”

HubSpot's screen was cancelled. Connect again when you are ready.

“The link didn't match this browser” or “HubSpot didn't accept the connection”

The connection started in another browser, or took too long. Connect again from Settings, in the same browser.

“Only an admin of this project can connect HubSpot”

Ask an admin of the project to connect it, or to make you an admin.

“HubSpot didn't answer, so remove Rasket in HubSpot's Connected apps yourself”

Rasket is disconnected, but HubSpot did not confirm the removal. In HubSpot, open Connected apps and uninstall Rasket.