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.
  • 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.
  • 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.
  • n8nGuidesThe Rasket node and trigger for n8n workflows: install, connect, every operation.
  • VercelGuidesAdd Rasket on Vercel: a Sending key in each project as RASKET_API_KEY, no copying.
  • WordPressGuidesThe Rasket plugin: every email your site sends, through Rasket, with a safe fallback.
  • 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.
  • PipedreamGuidesRasket actions and instant sources for Pipedream workflows and Connect apps.
  • FramerGuidesThe Rasket plugin: sign-up forms on a Framer site, and Framer forms into contacts.
  • MakeGuidesComing soon: send email and react to email events from a Make scenario.
  • monday.comGuidesTurn board items into contacts and send a template when a board changes.
  • ClickUpGuidesReady-made Zapier and Make automations between ClickUp tasks and Rasket.
  • SlackGuidesEmail alerts in the Slack channels you choose, and /rasket for numbers and look-ups.
  • 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.
  • ShopifyGuidesRasket for Shopify: customers with their consent, store events and ready-made flows.
  • 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.
  • 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.

GuidesShopify

Shopify

Rasket for Shopify connects your store to a Rasket project. Your customers arrive as contacts with their marketing consent, your products as a catalogue, and your carts, checkouts and orders as events that start flows: abandoned checkout, abandoned cart, browse abandonment, welcome, post-purchase and win-back.

Coming soon: Rasket is not in the Shopify App Store yet. This page describes the app as it will ship.

Install

  1. In the Shopify App Store, find Rasket and choose Install. Shopify shows the permissions the app asks for (below).
  2. The app opens inside your Shopify admin and asks where your store's emails should live.
  3. Choose Create a project for this store, or Connect an existing project if you already use Rasket.

Rasket never asks you to type your store's address. In Rasket, every Connect a store button takes you to the app's App Store page.

Create a project for this store

Rasket makes an account for the store owner's email address, and a project named after the store, and connects them. It emails a link to set a password, so you can sign in to Rasket itself later. If that address already has a Rasket account, connect an existing project instead.

Connect an existing project

Rasket opens in a new page. Sign in, pick the project and confirm. You need to be an admin of that project. A store connects to one project at a time, and a project can have more than one store.

Set up the app

The app's home in your Shopify admin is a short checklist. It shows where each step stands.

  1. Wait for the first sync. Rasket reads your customers, products and collections. You can close the page while it runs.
  2. Turn on tracking. This adds Rasket's pixel for checkouts. It runs in Shopify's sandbox and needs nothing in your theme.
  3. Switch on Rasket in your theme editor. Choose Open the theme editor, switch on Rasket under App embeds and save. This tracks product views and carts, and shows your sign-up forms. It does not change your theme's code.
  4. Add a flow. Switch one on under Store flows in the app's home, or in Rasket open Automations, then New, and choose the flow.

Tracking waits for your visitors' consent. Where your store shows a cookie banner, Rasket records nothing for a visitor until they allow analytics and marketing.

Who can be emailed

Each customer's email marketing consent in Shopify decides it. A store flow is marketing: it only ever emails a subscribed contact.

Email marketing consent
In ShopifyIn Rasket
SubscribedSubscribed. Flows and campaigns can email them.
UnsubscribedUnsubscribed. Nothing marketing reaches them.
Not subscribed, or pendingNever subscribed. Nothing marketing reaches them until they subscribe, in Shopify or through a Rasket form.
InvalidNot brought in.
RedactedErased from Rasket.

A contact your project already had keeps its own consent: Shopify never moves it from subscribed to never subscribed. When someone unsubscribes in Rasket, or signs up on a Rasket form on your store, Rasket records it on the customer in Shopify too. Subscribers synced from Shopify count towards your plan's marketing contacts. Never-subscribed customers do not.

Flows and email blocks

Each ready-made flow is added turned off, with its emails as drafts, so you can read and change them first.

Ready-made store flows
FlowWhat it does
Abandoned checkoutReminds a customer who started checkout and did not finish.
Abandoned cartReminds a customer who added to their cart and left.
Browse abandonmentFollows up on a product a customer looked at and did not buy.
Welcome with a discountGreets a new subscriber to your store's newsletter with a discount.
Post-purchase thank-you and reviewThanks a customer after an order and asks for a review.
Win-backBrings back a customer who has not ordered in a while.

A checkout or cart reminder stops as soon as the customer buys: before each reminder, Rasket checks with your store for an order. The email editor adds four store blocks:

  • Cart: the items from the cart or checkout that started the flow, with a button back to it.
  • Product: one product you pick from your catalogue.
  • Recommended: your best sellers, or what the customer looked at.
  • Discount: a unique code for each person the email goes to, created in your store.

New subscribers can join from your storefront through Rasket's sign-up forms, which the theme editor's app embed shows.

Revenue

An order counts towards an email when the customer clicked it in the five days before ordering, or opened it the day before. You can change both windows in Rasket under Settings, then Integrations, then Shopify. Revenue shows on each flow, each campaign, and the app's home in Shopify. Test orders are kept and counted nowhere.

Connection health

Every 15 minutes Rasket compares recent orders, checkouts and customers with your store and fills in anything a missed update left out. Events filled in this way never start a flow late. When orders stop arriving, or Rasket can no longer read the store, the app's home and the Shopify settings page say so, and your project's admins get an email.

Permissions

The app reads customers' email addresses and names only. It asks for no phone numbers or addresses.

Shopify permissions
PermissionWhy
read_customersBrings your customers in as contacts, with their email marketing consent.
write_customersTo record on the customer in Shopify an unsubscribe made in Rasket, or a sign-up on a Rasket form on your store, so both agree.
read_ordersOrders and checkouts start and stop your flows, and count towards revenue.
read_fulfillmentsStarts a post-purchase email when an order is fulfilled.
read_productsYour products and collections, for the product and cart blocks in emails.
write_pixelsAdds Rasket's checkout tracking pixel, which runs in Shopify's sandbox.
read_customer_eventsReceives the checkout events that pixel reports.
write_discountsCreates a unique discount code for each person an email goes to.
read_themesReads your published theme's fonts and colours, so sign-up forms can match your store.

Uninstall and your data

  • Uninstalling disconnects the store at once. Rasket forgets its access and stops every sync. Reinstalling within 48 hours reconnects it to the same project.
  • 48 hours after uninstalling, Rasket deletes everything the store sent it: the catalogue, events, browsers, discount codes and the connection. Your contacts stay in the project, without their store activity.
  • A customer's data request from Shopify is answered by email to your project's admins, with everything Rasket holds about that customer.
  • A customer's erasure request erases the contact if your store brought it in. If the contact was in your project first, Rasket deletes only what the store added.

Store events are kept for 90 days. Rasket is your processor for your customers' data under the Data Processing Addendum, and the privacy policy says how Rasket handles it.

Billing

The Shopify App Store page lists the plans and how they are billed. A project that already pays for Rasket keeps its plan when you connect a store.