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.

GuidesAddress verification

Address verification

An add-on that stops mail to addresses that don't exist before it is sent, so your bounce rate stays low and those sends never count toward your plan.

What is checked

Every email a project with the add-on sends is checked against Rasket's address book first: every address we have delivered to, received authenticated mail from, or seen bounce. An address we already know is answered at once and is free.

An address we haven't seen before gets, in order:

  • free checks: its spelling, its domain's mail servers, and known disposable and role addresses;
  • a mailbox check: we ask the address's own mail server whether the mailbox exists, from servers that never send mail, and never send a message.

Only the mailbox check is billed, once per address. Each answer is remembered, so the same address is never checked again.

What each verdict does

Address verification verdicts
VerdictMeansWhen you send
ValidThe mailbox exists.Sent.
InvalidThe mail server said the mailbox doesn't exist.Not sent.
RiskyA role address such as info@ or sales@, a disposable domain, or a domain that accepts every address.Sent with Send anyway; not sent with Don't send.
UnknownThe mail server wouldn't say, or we couldn't ask it.Sent.

You choose what a risky address does in Settings → Add-ons: Send anyway (the default) or Don't send. Don't send also refuses role addresses, which B2B mail often goes to.

A send to an address we don't know waits at most 1.5 seconds for its mailbox check, then goes out. Campaigns are checked ahead of sending.

When an address is refused

A refused address is not sent to and never counts as one of your plan's emails. It fires email.suppressed with reason failed_verification. A single send whose every recipient is refused answers 422, with details.cause failed_verification — see Errors.

Verify a list

On a segment's page or an import's page, Verify list checks every contact on it in the background. Before it starts you see how many addresses we already know (free), how many may need a mailbox check, and the most it can cost.

When it is done the page shows how many are valid, invalid, risky and unknown, with two buttons: Remove invalid deletes those contacts from your audience, and Tag risky adds the risky ones to a segment named Risky addresses. The same is in the API as POST /contacts/verifications.

Imports made before the add-on shipped can't be verified by import: verify a segment that holds them instead.

Price

$2 per 1,000 mailbox checks, on your next invoice. Addresses we already know and the free checks cost nothing. On a Shopify bill, checks are charged per started 1,000. It is available on every paid plan, and you can turn it off at any time.