Find clear answers about sending, deliverability, and email campaigns.

向已记录的沙盒地址发送邮件，例如 delivered@messagebird.dev、bounce@messagebird.dev 或 complaint@messagebird.dev。这些地址通过正常流程触发各种结果和 Webhook。将测试受众限定为沙盒地址；同一批次中的真实地址会收到真实邮件。

入门域名在其文档限制下支持首次发送，沙盒地址支持测试。正式发送前请验证您自己的发送域名。请查看工作区的当前限额，而非依赖本页的固定套餐配额。

使用首封邮件快速入门进行 API 集成，使用 SMTP 指南接入现有的 SMTP 应用，使用 Email marketing 发送营销活动，或使用代理邮箱快速入门处理对话。每条路径都链接到相应的设置和文档。

You can start on the Free plan with its included sending allowance to test integration and delivery. Paid Email plans add a monthly deposit directly to your shared Bird balance, and each email you send is billed from that balance at your plan's published per-email rate without expiring message bundles. Visit the pricing page to compare current deposits, rates, and plan allowances.

If you downgrade your plan, any custom handles you have already claimed continue receiving mail without interruption, and you can claim additional handles once your usage is back within your plan's limit. Mailboxes created on your own verified domain count toward your total mailbox quota without using any of your custom-handle allowance.

Dedicated IPs are available as a monthly add-on on eligible paid Email plans. You can check the current monthly price per IP and the maximum number of dedicated IPs included in each plan tier on the Email pricing page before ordering from the dashboard.

Your sending throughput and monthly allowances depend on your Email plan, with full tier details listed on the Email pricing page and any custom enterprise limits applied automatically. You can check your active rate limits and remaining quota through the API or response headers, and use the returned wait time to pace retries when requests are throttled. API and SMTP traffic share your sending throughput, while batch requests and campaign broadcasts follow their own request limits.

A complete email can be up to 20 MB, including the HTML body, plain text, headers, and encoded attachments. Because attachment encoding adds overhead, keep raw attachment files under 15 MB so the assembled message stays within the limit, and keep in mind that some recipient mail servers enforce smaller size caps.

When content storage is enabled, you can inspect sent message bodies and attachments for up to 30 days. For Agent Mailboxes, parsed headers, extracted text, and attachments stay available for 30, 90, or 365 days depending on the retention tier selected on your plan, while raw MIME payloads are retained for 30 days.

Scope the agent's API key to the specific permissions its workflow requires, and configure mailbox receive rules so untrusted senders do not trigger agent runs. For sensitive outbound communication, have the agent save a draft first so a human or policy check can verify the recipients, sender address, and body before sending.

可以，两者通过同一个发送 API 提交。唯一的区别是 category 字段，它决定了退订和取消订阅的适用规则。密码重置和收据选择 transactional，营销活动选择 marketing。

每次逻辑发送时附带一个 Idempotency-Key 请求头。如果第一次请求已成功但您未收到响应，使用相同的密钥重放请求会返回原始结果并附带 Idempotency-Replay 头，而不会重复发送邮件。

将 scheduled_at 设置为 30 秒到 30 天后的任意时间。发送请求会立即返回已接受状态，邮件保持计划状态直到发出，因此您可以在发送前随时取消。

可以，以 base64 编码放入 attachments 数组中。要在正文中内联显示图片，为其设置 content_id 并在 HTML 中通过 cid: 引用。原始文件大小请控制在 15 MB 以下，以确保编码后的邮件不超过 20 MB 上限，请注意可执行文件和脚本内容类型会在发送前被拒绝。

Yes. If your application or third-party software already sends email over SMTP, you can switch to Bird without rewriting code by updating the SMTP host, port, and credentials. Verify your sending domain in the dashboard and authenticate with an API key that has email sending permissions.

Connect on port 465 for implicit TLS encryption, or use ports 587 and 2525 with STARTTLS, including port 2525 for cloud environments that block standard mail ports. Point your client to the regional SMTP host that matches your API key; unencrypted submission on port 25 is disabled.

Use SMTP when you want a drop-in relay for existing services, CRMs, or frameworks that already assemble MIME messages. Choose the HTTP API when you want to send with stored templates, schedule deliveries, or pass structured JSON fields from your application code. Both methods share your verified domains, IP pools, suppression lists, and analytics.

SMTP messages are billed at the same published per-email rates as HTTP API sends under your Email plan, with no extra protocol fee. Check the Email pricing page for current plan rates, or talk with our team if you are migrating a high-volume SMTP workload.

Contacts live in your workspace and can store an email address, a phone number, your own external user ID, and custom attributes. Audiences reference those shared contact records, so when a customer updates their email address or profile details, the change carries across the audiences they belong to.

Upload a CSV, TSV, or Excel file in the dashboard, map your columns to contact attributes, and assign the imported contacts straight to an audience. To keep lists synchronized from your application, you can create or update up to 1,000 contacts per request through the API or CLI.

Audiences use explicit membership that you manage by adding or removing contacts through file imports, the dashboard, or the API. When a scheduled broadcast starts sending, Bird resolves the audience's current members so recent additions and removals take effect automatically.

You can define text, number, boolean, and date-time attributes with optional fallback values for missing data. Those attributes plug directly into your email templates so you can personalize subject lines and body copy for each recipient.

Select a saved audience when setting up your broadcast. When sending starts, Bird resolves the current audience members, filters out suppressed or unsubscribed addresses, and personalizes the template with each contact's saved attributes.

Yes. You can send a broadcast immediately or schedule it up to a year in advance, and you can edit or reschedule the campaign before delivery begins. If you cancel a broadcast that is scheduled or in progress, Bird stops delivery to any remaining recipients.

Broadcasts send a campaign to a saved audience up to a year ahead. For individual transactional emails, the sending API lets you schedule a message from 30 seconds to 30 days in advance. When you schedule a transactional send, Bird locks in the template version, language, and personalization values at request time so later edits do not alter your queued message.

Yes. Create a test audience populated with Bird sandbox addresses to simulate deliveries, bounces, and spam complaints without sending mail to real inboxes. Sandbox sends trigger your webhooks and appear in your analytics so you can verify your webhook and analytics integration before launching a live campaign, and they count toward your sending allowance.

Marketing broadcasts and transactional emails share your verified domains, templates, and delivery infrastructure, so you do not have to sync templates or suppression lists across two separate providers. Marketers can compose and schedule broadcasts in the dashboard, and developers can automate audience updates and campaign setup through the API, CLI, or MCP tools.

When you send a marketing broadcast or tag an API send as marketing, Bird includes one-click list-unsubscribe headers and an unsubscribe link for Gmail and Yahoo compliance. When a recipient opts out, Bird records their preference and filters them out of future marketing sends while still allowing transactional receipts and account alerts through.

Each broadcast report tracks delivered messages, human opens with automated privacy proxy prefetches filtered out, link clicks, bounces, and spam complaints. To tie campaigns back to signups or purchases, include UTM or custom link parameters and measure conversions in your product or analytics tool.

Use broadcasts in the dashboard to send newsletters, product announcements, and scheduled promotions to your saved audiences. For event-driven lifecycle emails such as welcome series, onboarding nudges, or cart reminders, trigger templates directly from your application backend using the Email API.

No. You can write and preview HTML templates in the dashboard code editor, or manage template files from your repository using the API, CLI, and MCP tools. If your team builds templates with React Email, you can compile them to HTML with Bird personalization placeholders intact and sync the output to the same drafts and published versions visible in the dashboard.

Templates use Liquid placeholders to merge dynamic data into subject lines, preview text, and message bodies. When you send a broadcast, Bird populates contact placeholders automatically from each recipient's saved profile attributes and fallback values. When you send transactional emails through the API, you can pass custom parameters such as order numbers or line items and use Liquid conditionals and loops to format the message.

Yes. Edits are saved to a working draft while live traffic continues using your currently published version. When you publish a change, Bird creates a version snapshot, and you can roll back to any earlier snapshot with one click if you spot a mistake, without affecting messages that have already been accepted for delivery.

Yes. A single template can store localized subject lines, preview text, and HTML bodies for multiple languages alongside a default fallback language. You can choose whether sends requesting an untranslated locale fall back to your default language or return an error, and preview each locale with sample recipient data before publishing.

我们会为您生成所需记录：一条 DKIM TXT 记录用于签名邮件，一条 return-path CNAME 记录用于对齐 SPF（无需顶级域 SPF 记录），以及一条 DMARC TXT 记录。用于品牌化打开和点击链接的跟踪 CNAME 是可选的。添加域名，将记录粘贴到您的 DNS 服务商处，然后点击验证：大多数验证在 DNS 传播后几分钟内即可完成，偶尔可能需要更长时间。

DMARC 告知接收服务器如何处理 DKIM 或 SPF 对齐失败的邮件，以及将显示谁在以您的域名发送邮件的聚合报告发送到哪里。我们要求在域名可以发送邮件之前必须设置 DMARC 记录，建议从 p=none 开始，即仅监控而不影响投递。一旦您确认所有合法来源都已对齐，再将策略收紧到 p=quarantine 或 p=reject。如果您的域名或父域名已发布了 DMARC，我们会直接使用。主要邮箱服务商现在要求批量发送者发布策略，因此拥有 DMARC 记录越来越成为大规模送达收件箱的必要条件。

两者都可以，我们推荐使用专用子域名，因为它可以将您的邮件信誉与企业邮件隔离开来。您还可以为事务性邮件和营销邮件分别使用不同域名，或每个品牌一个域名，各自拥有独立的身份验证和信誉。

当您的发送量稳定且需要控制自身 IP 声誉时，可以考虑使用独立 IP。发送量低或不规律的发送者使用共享池可能更合适。Bird 会在大约 30 天内自动预热新的独立 IP，预热期间溢出流量通过共享基础设施路由。选择前请与邮件专家确认您的发送模式。

可以。将 IP 分组为池，并将每种流量类型路由到各自的池。这样可以隔离承载营销活动和事务性流量的 IP。身份验证、域声誉和收件人互动对两者都很重要。

Bird handles SPF, DKIM, and DMARC authentication, dedicated IP pools with automated warmup, bounce and complaint suppressions, unsubscribe preferences, and real-time delivery analytics. You control list acquisition, message content, and sending cadence, and you can pair those controls with Inbox Insights to monitor inbox placement across providers.

Start in the dashboard or analytics API by breaking down bounce reasons and spam complaints by sending domain and mailbox provider, such as Gmail or Yahoo. You can inspect individual delivery attempts in the email log to see exact server responses, and use Inbox Insights to run seed tests or check whether providers are routing your mail to spam.

No. Health statuses like Healthy, Watching, and Throttled give you an early warning when bounce or complaint rates rise, without automatically pausing your traffic or changing your rate limits. Your team stays in control of whether to pause a broadcast or clean an audience while investigating.

When an address hard bounces, Bird adds it to your suppression list and blocks future sends to protect your sender reputation. Spam complaints and unsubscribes automatically stop future marketing emails to that recipient while allowing critical transactional messages, such as password resets or receipts, to reach valid addresses.

硬退回会为所有邮件创建抑制；投诉会为非事务性邮件创建抑制。手动抑制会阻止所有类别。软退回和延迟不会创建永久的收件人抑制。

退订会在偏好设置选项卡中记录收件人的偏好。它与抑制列表是分开的。在决定是否投递时两者都会被检查，删除联系人不会清除其退出记录。

在查明原因后，您可以通过控制面板或 API 移除屏蔽记录。移除一条屏蔽记录不会移除其他拦截记录或退订偏好。suppressed@messagebird.dev 沙盒地址允许您在不更改列表的情况下测试被拒收件人。

使用 Email Lookup，配合具有 lookup 权限的 API 密钥。提交一个地址并读取其结果、投递置信度、风险标记以及拼写建议。仪表板、SDK 和 CLI 提供了尝试相同查询的方式。

文档中列出的结果值包括 valid、neutral、risky、undeliverable 和 typo。将 result 视为开放词汇表，使用 delivery confidence 处理未来新增的值。valid 布尔值是服务商的有效性评估；请结合 result 和 confidence 一起判读，因为它本身不能保证送达。

向用户展示拼写建议让其确认；不要默默替换其地址。neutral 表示无法确认也无法否认该邮箱的存在。将结果和置信度与你的同意和发送策略结合使用。

不能。查询有助于评估当时的地址质量，但不能建立同意、移除退出偏好或保证进入收件箱。请继续遵守抑制和偏好记录。

使用批量 API 在一次请求中验证最多 1,000 个地址，请求大小不超过 128 KiB。结果按提交顺序返回，包括重复项。每个已应答的条目都会计费。重试批量请求前，请查阅文档中的重放限制；本页不提供列表上传控件。

You can track delivered messages, opens, clicks, bounces, spam complaints, and delivery latency. Filter and group performance by sending domain, recipient domain, mailbox provider, tag, template, or broadcast to spot trends quickly. You can also inspect delivery and bounce rates by sending IP to monitor infrastructure health.

Analytics update within minutes as delivery and engagement events arrive, and each report includes a freshness timestamp so you know how current the numbers are. Metrics are recorded when the event happens, meaning a link clicked on Tuesday appears in Tuesday's activity even if the email was sent earlier in the week. You can query hourly or daily rollups across the dashboard and reporting API.

Delivery metrics confirm that the recipient's mail server accepted your message. To see whether accepted emails land in the primary inbox or the spam folder across major providers, use Inbox Insights, and use Competitive Insights to benchmark competing brands. To measure revenue or signups, pass campaign tags or link parameters into your application's analytics.

No. You can generate a Bird forwarding address in seconds and forward emails from your existing inbox to start testing right away. When you are ready to receive mail directly on your own brand, you can configure a receiving subdomain.

Yes. Register and verify a dedicated subdomain in Bird, enable inbound receiving, and publish the provided MX records in your DNS. Using a dedicated subdomain lets Bird process application replies and support tickets while your primary domain continues routing employee mail to Google Workspace or Microsoft 365.

Bird sends a webhook notification to your server as soon as an incoming email arrives, and your app can fetch the parsed subject, plain text, HTML body, headers, and attachments through the API. You can verify webhook signatures to confirm each request came from Bird and rely on automatic retries if your endpoint is temporarily unavailable.

Inbound email turns incoming messages on your receiving domain or forwarding address into structured webhook events and parsed content for your backend. Agent Mailboxes give each AI agent or support workflow a dedicated inbox that tracks multi-turn conversation threads, filters unwanted senders, and sends replies in context.

Inbound email parses incoming messages and forwards them to your webhook endpoint for one-way processing. An agent mailbox gives your AI agent or support app a persistent inbox that groups messages into conversation threads, strips quoted reply history to keep prompts clean, enforces sender admission rules, and sends threaded replies.

Yes. You can create mailboxes on any verified domain or subdomain where you have enabled inbound receiving. For quick setup without DNS changes, you can also provision a generated or custom handle on Bird's managed inbox domain, which stays reserved to your workspace even if you delete the mailbox later.

Parsed message headers, clean extracted text, and attachments are stored for 30, 90, or 365 days based on the retention period you choose for your plan. Raw MIME files and unparsed original bodies are kept for 30 days so you can debug formatting or delivery issues.

Yes. Configure mailbox webhooks to trigger your agent automatically whenever an admitted message lands in the inbox, or connect to the live event stream for real-time updates during an active session. If a streaming connection drops, your agent can list recent thread messages through the API to catch up on anything that arrived while disconnected.

Inbox Insights is the current Bird dashboard experience for inbox placement and seed testing, replacing the older Inbox Tracker name. If your organization uses a standalone eDataSource or legacy Tracker account, you can continue signing in through that platform's existing portal and support team.

Your delivery rate shows how many emails were accepted by recipient mail servers, which includes messages that later get filtered into spam. Inbox Insights shows where those accepted messages actually land across major mailbox providers, breaking down primary inbox versus spam folder placement alongside your delivery metrics.

Verify your sending domain in a workspace with Inbox Insights enabled and turn on domain tracking. Once active, panel placement estimates populate for supported mailbox providers as your domain sends volume, and you can run seed tests using your plan's seed testing allowance.

No. Creating a seed test reserves a set of test addresses for you to include in your campaign audience or pre-send test list before the expiration date. Placement results populate in your dashboard as those seed mailboxes receive your email, and reserving a test uses one test from your allowance.

You can see inbox, spam, and missing counts for each measured mailbox provider, verify that SPF, DKIM, and DMARC passed on the received messages, and compare how engaged versus dormant test mailboxes filtered your campaign.

Inbox Insights is designed for interactive investigation in the Bird dashboard, where you can inspect placement trends and seed test results visually. For programmatic reporting on your sent volume, bounces, opens, and clicks, use the Email analytics API.

Yes. Competitive Insights is the Bird dashboard tool for tracking competing brands and benchmarking their email programs, replacing the older Competitive Tracker name. If your team uses a legacy standalone account, you can continue accessing it through its existing sign-in and support path.

Competitive Insights estimates volume and engagement from a representative panel of consumer mailboxes, tracking each watched brand's primary high-volume sending domain. Mail sent from secondary domains or very low-volume senders may not appear in the panel sample.

Yes. The campaign feed displays captured subject lines and rendered email screenshots when available from the panel. It focuses on observed broadcast campaigns to help you review messaging, cadence, and seasonal promotions across your industry.

Treat them as complementary signals. Competitor read rates come from observed mailbox activity in the measurement panel, whereas your own open rates come from tracking pixels in the emails you send. The dashboard labels panel estimates alongside your own delivery metrics so you can compare directional trends accurately.

Yes. Each brand profile lists the detected email service provider when the panel can identify it from message headers and sending infrastructure. If a sender's provider cannot be verified from observed mail, the field stays blank.

Open Competitive Insights in the Bird dashboard, search for competitors by brand name or sending domain, and add them to your watchlist up to your plan's brand allowance. You can also book a demo with our team to check panel coverage for your industry before you subscribe.

Both are self-managed mail transfer agents for organizations that run their own sending infrastructure. Momentum MTA is designed for carrier-grade, high-volume environments that need deep policy customization and routing control. PowerMTA gives enterprise senders high-throughput delivery and granular queue management on their own hardware or public cloud instances in AWS, Azure, or GCP.

Momentum MTA and PowerMTA fit enterprises and mailbox providers whose compliance or infrastructure policies require running dedicated mail servers on-premises or in their own cloud. Inbox Insights and Competitive Insights are cloud tools in the Bird dashboard for any sender who wants inbox placement testing and competitor benchmarking, and you can use both without self-hosting an MTA.

SparkPost 属于 Bird。Bird Email 为新项目提供发送、活动和投递工作流。现有的 SparkPost 集成是独立的集成：在规划迁移之前，请与你的客户团队一起审查其 API 调用、域记录和事件。

Bird Email 有自己的 API 和 SDK。请查阅发送、模板、域和 webhook 指南，不要假设 SparkPost 请求可以原样发送。

Momentum 是我们面向大批量发送的本地部署邮件基础设施平台，通过其 Policy Manager 提供可自定义的工作流、路由和投递参数。它能随发送量扩展并保持稳定性能，且支持完整 Unicode（SMTPUTF8），可发送至国际字符集地址。

Adaptive Delivery 是 Momentum 的自动流量整形功能。它监测每个邮箱服务商对您邮件的响应，并实时调整：限流、延迟或短暂暂停某条发送流以保护您的信誉，待情况好转后再恢复发送速率。您无需为每个服务商手动调控发送速率即可达到收件箱。Intelligence Router 可跨所有数据源展示这些调整过程，并在每次调整时发出实时警报。

两者皆是。Momentum 可运行在您自己的服务器、任何主流云平台，或混合部署，以匹配您的基础设施、成本和合规需求，并可随时调整配比。它也在持续更新：近期版本保持对现代操作系统、TLS 1.3 以及最新安全和 SMTP 标准的支持，并通过实时 API 暴露消息事件，供您接入自有报告和自动化系统。

可以。PowerMTA 可以将部分流量中继到托管的 Bird Email API，其余流量直接从您自己的服务器发送——这是试用托管平台或逐步迁移最简单的方式，无需一次性全部迁移。PowerMTA 本身运行在您自有的基础设施上，这些 IP 由您自行管理。中继到托管平台的流量可以使用我们的 IP，也可以使用您的专用 IP，其他一切完全由您掌控。

虚拟 MTA 允许你在一个 PowerMTA 实例内运行多个独立的发送流，每个流有自己的 IP、信誉和限制。用它们分别管理事务性邮件、营销邮件或不同客户。共享域和收件方提供商的策略仍可能影响跨流的投递。

Yes. API requests require HTTPS, and SMTP submission requires TLS encryption on port 465 or a completed STARTTLS upgrade on ports 587 and 2525 before authentication is accepted, keeping your credentials encrypted in transit. Unencrypted submission on port 25 is disabled. To keep data in your chosen region, send through the regional endpoint that matches your API key; Bird's official SDKs and CLI detect the key's region prefix and route requests automatically.

You choose the exact read or write permissions for each API key across email sending, marketing campaigns, and domain management, so a key created for an application server to send receipts cannot modify your domains or access unrelated resources. Administrative actions such as managing team members, workspace settings, API keys, and IP pools require an authenticated user session. You can also attach an IP address allowlist to any key so requests from unfamiliar networks are rejected.

When you rotate an API key, Bird issues a replacement key immediately and keeps the previous key active for a configurable grace period (24 hours by default) so you can roll out the new credential across your services without dropping traffic. If a key is compromised, you can set the grace period to zero to revoke it right away, and you can assign a custom expiration date to the new key if your security policy requires periodic rotation.

Yes. Bird supports enterprise single sign-on over SAML 2.0 and OIDC with identity providers such as Okta, Microsoft Entra ID, and Google Workspace. Your account team can enable SSO for your organization, and team members who sign in with an email and password can enable multi-factor authentication on their own accounts.

Yes. The organization audit log records configuration and administrative changes in a read-only timeline showing the actor, workspace, timestamp, and outcome, and you can export entries in OCSF format to your SIEM. The audit log tracks account and infrastructure actions, while individual sent and received emails are recorded in the email log.

You can download compliance certifications and security documentation from the Bird Trust Center at trust.bird.com, and review our data processing agreement, privacy statement, and acceptable use policy at bird.com/legal. If your procurement or security team requires a custom vendor questionnaire, contact your account team.