Skip to content
Docs
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.
  • 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.
Documentation
Sign inGet started

GuidesFramer

Framer

The Rasket plugin for Framer puts your Rasket sign-up forms on a Framer site, and sends the forms you build in Framer to your Rasket contacts.

Coming soon: the Rasket plugin is not in Framer's Marketplace yet. This page describes it as it will ship.

What it does

  • Inserts a Rasket sign-up form. Pick one of your live embedded forms and the plugin adds it to the page. It shows the published version, with its consent box and double opt-in if the form uses them.
  • Adds rasket.js to the site. One script in every page's head, so your pop-ups and flyouts show and store flows can follow a visitor who agreed.
  • Connects a Framer form. Rasket gives you an address and a secret to paste into the form's webhook. Each submission becomes a contact.

Before you start

  • A live embedded sign-up form, to insert one. Build and publish it in Rasket under Audience, then Forms.
  • A published Framer site. Rasket accepts sign-ups only from your site's own address, so publish once before you insert a form.
  • An admin of the Rasket project, to sign in. The plugin acts as you, with only the access you approve.

Sign in

  1. In Framer, open the Rasket plugin and choose Sign in with Rasket. Your browser opens Rasket.
  2. Sign in to Rasket if you need to, pick the project, and approve what the plugin asks for.
  3. Rasket shows a code. Check that the plugin shows the same code, then choose Framer shows this code. If it does not match, choose It doesn't match and nothing is connected.
  4. Go back to Framer. The plugin finishes signing in and shows your project's name.

A sign-in lasts ten minutes. To switch project, choose Sign out in the plugin's menu and sign in again. Each Framer project remembers its site entry per Rasket project, so switching back finds it again.

What the plugin may do
It asks forWhy
team:readShow which Rasket project you signed in to.
contacts:readList your live sign-up forms and your connected Framer forms.
contacts:writeConnect and disconnect a Framer form.
topics:readList the topics a Framer form can subscribe people to.
events:read, events:writeFind or create the site entry that lets your site send sign-ups.

Insert a sign-up form

  1. In the plugin, open Sign-up form and pick the form.
  2. Choose Insert form. The first time, the plugin adds a RasketForm.tsx code file to your project.
  3. Place the form on the page, then publish the site.

On the canvas the form is a preview. On the published site it shows exactly what you published in Rasket. To change its words or colours, edit the form in Rasket and publish it again; the Framer site picks the change up without republishing.

Add rasket.js

Turn on rasket.js on this site and confirm. The plugin adds one script to every page's head. It sends nothing until a visitor agrees to tracking. Turn it off in the plugin, or in Framer under Site Settings, then Custom Code. Inserted forms keep working without it.

Connect a Framer form

  1. In the plugin, open Framer form and fill in the form below.
  2. Choose Connect form. The plugin shows a URL and a secret. The secret is shown once.
  3. In Framer, select the form. Under Send To, choose Webhook and paste the URL and the secret.
  4. Publish the site and submit the form once to try it.
Connect a Framer form
FieldWhat it takes
NameWhat you call the form. Only you see it.
Topic people joinOne of your project's topics. Create one in Rasket first.
Email field nameThe Name of the form's email field in Framer, such as Email.
First name field nameOptional. The Name of a field with the person's first name.
How people agree to emailA checkbox field people tick, or your confirmation that everyone who submits agreed, or neither. With neither, people are added but not subscribed.
What your form says about emailThe words beside your form's checkbox. Rasket keeps them with each sign-up as evidence.

Field names match without regard to case. A checkbox counts as yes when Framer sends on, true or yes. To stop a form, choose Disconnect in the plugin: its URL stops answering at once.

Consent

  • Inserted forms record the published version a person saw, with its consent text, exactly as every Rasket sign-up form does.
  • Framer forms subscribe a person only when the opt-in field says yes, or when you confirmed everyone agreed. Otherwise the person is added but not subscribed, and campaigns skip them.
  • No form re-subscribes anyone who said no. An unsubscribed contact, or one who opted out of the topic, is left as they are. Framer forms have no double opt-in; use an inserted Rasket form for that.

The integrations overview lists the other ways to bring people into Rasket.

Troubleshooting

  • “Publish this site once.” The site has no published address yet. Publish it, then open the plugin again.
  • The form does not appear on the site. Check the form is still live in Rasket and is an embedded form. A paused form disappears within about ten minutes.
  • “rasket.js is turned off for this site.” Someone switched it off under Custom Code. Turn it back on there.
  • Framer form submissions do not arrive. Check the URL and the secret are both pasted, and that the email field's Name matches. If you lost the secret, disconnect the form and connect it again.
  • “You were signed out.” A sign-in must be approved again within 90 days, or after 30 days unused. Sign in again.