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.
  • 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.
  • 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.
  • IntegrationsGuidesVercel, Netlify and Cloudflare, Zapier and n8n, a WordPress plugin, and Notion contacts.
  • 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.
  • 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.

GuidesMigrating to Rasket

Migrating to Rasket

Bring your contacts, unsubscribes, lists, segments, templates and draft campaigns from Mailchimp, Klaviyo, SendGrid, MailerLite, or an export file. A migration only reads, and it never sends anything.

How it works

  1. In the dashboard, open Audience → Import & migrate and click + Import.
  2. Pick your platform and paste its key, or choose a file.
  3. We count what is there. Review the list: everything is ticked, and the plan line says how many contacts count on your plan and what that costs.
  4. Answer the few checks that need an answer, then start the import. You can close the tab; the run keeps going and shows in the Import & migrate list.
  5. When it finishes, a report arrives by email with a warm-up plan.

One migration runs at a time per project. Running it again from the same account updates what came over before; it never makes duplicates.

What every migration does

  • Suppressions come first and always. Unsubscribed, bounced and complained addresses come over suppressed before any contact is written. They never get mail and never count on your plan, and they cannot be unticked.
  • Lists become topics. Each contact keeps their subscriptions. A contact who never subscribed comes over unsubscribed.
  • Segments become segments. A segment is a live rule when every condition has an exact match in Rasket, and a fixed list of today's members, marked as one, when it does not.
  • Templates and drafts come over as HTML, with merge tags converted to Rasket variables. Drafts stay drafts: nothing is sent or scheduled.
  • Your key is stored encrypted while the migration runs and deleted when it finishes, when you cancel, or after a day with nothing happening. It is never shown or logged.

A migration never sends. Your contacts hear nothing until you send a campaign yourself.

Mailchimp

Paste a Mailchimp API key. To make one:

  1. In Mailchimp, open your profile menu and choose Account & billing.
  2. Go to Extras → API keys and click Create a key.
  3. Name it Rasket, copy the key and paste it here.

Mailchimp has no read-only key, so the key can do anything in your account. We only read with it; delete it in Mailchimp once the import is done. Audiences become topics, tags a property and a segment, and saved segments segments. Templates come over as their editable sections in plain HTML, because Mailchimp's API does not return a template's design. Customer Journeys, classic automations, forms and landing pages stay behind.

Everything that comes over from Mailchimp, and what stays behind, is on Migrate from Mailchimp.

Klaviyo

Paste a Klaviyo private key with Read-only access. To make one:

  1. In Klaviyo, open Settings → API keys.
  2. Click Create private API key and choose Read-only access.
  3. Copy the key (it starts with pk_) and paste it here.

We check the key can read each area as you paste it, and name the one it cannot. On a large account the scan shows contacts as “at least” a number, because Klaviyo gives no total; the import still brings every profile. Flows stay behind, and the report names each one so you can rebuild it.

Everything that comes over from Klaviyo, and what stays behind, is on Migrate from Klaviyo.

SendGrid

Paste a SendGrid API key with Restricted Access. To make one:

  1. In SendGrid, open Settings → API Keys and click Create API Key.
  2. Choose Restricted Access. Set Marketing, Suppressions, Template Engine, Design Library, Sender Authentication and Stats to Read.
  3. Copy the key (it starts with SG.) and paste it here.

Pick EU beside the key if your account is in SendGrid's EU region. A key that cannot read suppressions is refused, so a bounced address never comes over sendable. SendGrid hands contacts over as an export, which can take a few minutes to prepare; asking for that export is the one thing we ask SendGrid to do, with its notification email off. Unsubscribe groups become topics. Segments come over as fixed lists, and blocked addresses stay behind, because a block is temporary. Number and date fields keep their type. Designs come over as templates, and past single sends keep their subject and HTML. Your verified sender's name and postal address are offered for Settings → Sender, and your authenticated domains are listed to add here.

Everything that comes over from SendGrid, and what stays behind, is on Migrate from SendGrid.

MailerLite

Paste a MailerLite API token. To make one:

  1. In MailerLite, open Integrations → MailerLite API.
  2. Click Generate new token and name it Rasket.
  3. Copy the token and paste it here. Use a token from the new MailerLite, not MailerLite Classic.

MailerLite tokens have no scopes, so the token can do anything in your account. We only read with it; delete it in MailerLite once the import is done. Groups become topics and segments fixed lists. MailerLite's API has no templates and gives a campaign's text rather than its design, so drafts arrive as text to restyle. Each subscriber's last open or click is read from their activity, which makes a big list slower. Forms are listed by name on the report so you can rebuild them. A MailerLite Classic account is not supported: move to the new MailerLite first, or upload an export.

Everything that comes over from MailerLite, and what stays behind, is on Migrate from MailerLite.

Substack and other files

Choose Use a file instead, or the file tile, and upload a CSV or a ZIP of CSVs, up to 50 MB. We recognise these exports by their columns:

Exports Rasket recognises
ExportWhat the file isWhat comes over
SubstackA zip from Settings → Exports, emailed when it is ready.Subscribers as one topic, those who turned email off as unsubscribed, the plan and paid status as properties, each reader's last open, and published posts in the archive.
MailchimpA zip with one CSV per contact status.The audience as one topic, its contacts with their opt-in times and IPs, and the cleaned file's addresses as bounces.
KlaviyoA CSV of one list or segment.Profiles with their email consent, as a topic.
Klaviyo suppressed profilesA CSV of suppressed profiles.Each address suppressed, with its reason and date.

Any other CSV is matched column by column: pick which columns are the email, the name and the unsubscribed flag, and every other column becomes a property. Each list in a file becomes a topic, and HTML files in a ZIP become templates. Segments and draft campaigns come over when you connect the platform instead. The file is deleted seven days after the import ends.

Everything that comes over from Substack, and what stays behind, is on Migrate from Substack.

After the import

The report says what came over, what needs a look, and a warm-up plan: send to your recently engaged contacts in the first week and to the rest over the following weeks, so mailbox providers get to know your sending domain. It is advice, not a limit.

Something stopped? A paused run keeps everything it brought over. Paste a new key if the old one was refused, and resume from the run's page.