Transactional & Marketing Mail

Transactional & Marketing Mail is a sending-only email service. Your applications send through it over SMTP or the HTTP API: sign-up confirmations, password resets, receipts and alerts (transactional mail), or newsletters and promotions (marketing mail). Yeap Cloud signs each message with DKIM for your domain, delivers it, handles bounces and complaints, and reports every step back to you as events.

In the console it lives under Email sending in the Email section of the left-hand navigation (/tm/streams).

#Key concepts

#Plans

At the time of writing these plans are available. The New stream dialog in the console shows current prices and limits.

• Free plan volume comes from your credit level: 100 emails a month at Lv1, rising to 3,000 at Lv6. An account can have only one free stream. Paid plans don't get this allowance: they include the volume in the table.
• Hourly limit on paid plans is the plan value multiplied by your level factor: ×0.5 at Lv1, ×0.75 at Lv2, ×1 at Lv3, ×1.25 at Lv4, ×1.5 at Lv5 and ×2 at Lv6.
• Annual billing costs 10 times the monthly price (¥390, ¥1,290 and ¥4,990 a year), so you get two months free.
• One email = one recipient. A message sent to three recipients counts as three emails against the monthly volume and the hourly limit.
• Overage is billed per started block of 1,000 emails. Each paid plan has a spending cap on unpaid overage (¥200, ¥1,000 and ¥5,000). When the cap is reached, sending stops until you pay the overage bill. See Limits, sandbox and compliance.
• The free plan starts in the sandbox; paid plans skip it. The sandbox lifts when your account reaches Lv2.

#Credit levels

Your account has a credit level from Lv0 to Lv6. New accounts start at Lv1. On the free plan, the level sets your monthly volume and hourly limit. On paid plans, it scales the hourly limit, marketing streams need Lv2 or higher, and Lv5 and Lv6 get slightly more tolerant automatic-pause thresholds. At Lv0 the account can't send. Levels are evaluated daily and go up one at a time as your account gets older, sends more delivered mail and keeps bounce and complaint rates low. Lv2 only needs a verified account email, one verified sending domain and an account at least 7 days old. An automatic pause lowers your level by one, and sending a virus drops it to Lv0.

The Trust level card on the Email sending page shows your current level, how much of this month's free allowance you've used (free plan), and what the next level requires. The full table is in Limits, sandbox and compliance.

#Quick start

1. Open Email sending and click New stream.

2. Choose a plan, enter a Name such as my-app, and choose the Type: Transactional or Marketing. Marketing is only available on paid plans, and your account needs credit level Lv2 or higher to send marketing mail. If the plan offers several billing cycles, choose one under Billing cycle.

3. Click Add to cart and pay at checkout. The stream appears in the list once payment is complete.

4. Open the stream, go to the Sending domains tab and click Add domain. Enter the domain you want to send from, for example example.com or mail.example.com.

5. In the DNS panel that opens, add the records. If the domain is hosted in Yeap Cloud DNS, click Add in one click. Otherwise, add the records at your DNS provider. See Sending domains and DNS.

6. Click Verify. The domain shows Verified once its DKIM record is live.

7. Go to the API key tab, click Create key, enter a name and copy the key. It's shown only once.

8. Send a test message:

   bashCopy

   curl -X POST https://api.tm.yeapcloud.net/v1/send \
     -H "Authorization: Bearer ytm_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{
       "from": "Example <noreply@example.com>",
       "to": "you@example.com",
       "subject": "Hello from Yeap Cloud",
       "text": "It works."
     }'

9. Open the Message log tab to follow the message from Queued to Delivered.

#The stream page

Click a stream in the list to open it. Depending on the stream, these tabs are available:

#Stream status

#Next steps

• Sending domains and DNS: add and verify the domains you send from.
• SMTP and HTTP API: connect your application and send mail.
• Events and webhooks: track delivery and receive events on your server.
• Suppressions and unsubscribe: manage who doesn't get mail, and how unsubscribing works.
• Limits, sandbox and compliance: credit levels, sending limits, overage, automatic pauses and the sending policy.