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.
  • 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.

GuidesSending newsletters

Sending newsletters

A newsletter needs a way to unsubscribe. Send it as a campaign and Rasket handles that for you; send it through the API or SMTP and the email has to carry the link itself.

Use a campaign

A campaign sends one email to a segment of your contacts. It adds the unsubscribe link and the one-click unsubscribe header, keeps unsubscribed people off the next send, and counts the subscribers your plan includes. That is the right tool for a newsletter, an announcement or a product update.

What counts as a newsletter

Rasket looks at what each email sent with POST /emails, POST /emails/batch or the SMTP relay says, with the recipient's own name and address taken out. When the same content reaches 500 different people within 24 hours and has no unsubscribe link, it is counted as a newsletter.

  • Receipts, password resets, sign-in links and shipping notices are not counted: an order number, a total or a token makes each copy different.
  • Campaigns and flows are never counted. They handle unsubscribes themselves.
  • to, cc and bcc all count. A suppressed address doesn't.

What happens

  • The first time, nothing is blocked. Your team's admins get an email and the dashboard shows a notice.
  • After that, the next newsletter sent this way — at least 24 hours after the warning, or any after 7 days — is refused with 422 validation_error and details.reason bulk_requires_unsubscribe. Over SMTP the relay answers 550 5.7.1.
  • Adding an unsubscribe link lets the same email through at once. You don't need to contact us.

The full response is on Errors.

A link to a web page, or a mailto: address, whose address or text says unsubscribe. In a plain-text email, a line that says it and carries the link. The word on its own, with no link, doesn't count.

<p>
  You're getting this because you signed up at example.com.
  <a href="https://example.com/unsubscribe?u=8f2c">Unsubscribe</a>
</p>

These words count, in any letter case and with or without accents:

unsubscribe, un-subscribe, opt out, opt-out, optout, manage preferences, manage your preferences, email preferences, subscription preferences, manage subscription, manage your subscription, desabonner, desabonnement, desinscrire, desinscription, abmelden, abbestellen, darse de baja, dar de baja, cancelar suscripcion, cancelar la suscripcion, cancelar inscricao, descadastrar, disiscriviti, annulla iscrizione, cancella iscrizione, uitschrijven, afmelden, avsluta prenumeration, avregistrera, afmeld, avslutt abonnement, wypisz sie, odhlasit, abonelikten cik.

The link must work: it should stop that person getting the newsletter, and you should keep them off your next send. Mailbox providers expect the same of any bulk sender.

If your email is not a newsletter

Some legitimate mail is the same for everyone: an outage notice, a policy change, a security notice to every user. If yours is refused, reply to the warning email or contact support and we can allow it for your team.