Send your first email

By the end of this guide you will:

• Have an email qube set up on one of your domains.
• Have SPF, DKIM, and DMARC records published in DNS automatically.
• Have sent a real email through the API and seen it arrive.

1. Add the email qube

   From your project dashboard, click Add qube and pick Email. Choose the domain you want to send from. The qube needs DNS to be managed by CloudQube (or BYO DNS pointed at our nameservers) so it can publish the SPF/DKIM/DMARC records itself.

2. Wait for DNS propagation

   The qube publishes the records and polls until they propagate. Typically under a minute for CloudQube-registered domains, up to ten minutes for BYO domains depending on your registrar’s DNS TTL.

3. Generate an API key

   In your account settings, go to API keys and create one with the email:send scope. Copy the key; you will not see it again.

4. Send a test email

   Substitute your domain and your test inbox.

   curl

   curl -X POST https://api.cloudqube.eu/v1/email/send \
     -H "Authorization: Bearer $CLOUDQUBE_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "from": "hello@yourdomain.eu",
       "to": "you@example.com",
       "subject": "First email from CloudQube",
       "text": "Hello from your new email qube."
     }'

   JavaScript

   const res = await fetch("https://api.cloudqube.eu/v1/email/send", {
     method: "POST",
     headers: {
       Authorization: `Bearer ${process.env.CLOUDQUBE_API_KEY}`,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
       from: "hello@yourdomain.eu",
       to: "you@example.com",
       subject: "First email from CloudQube",
       text: "Hello from your new email qube.",
     }),
   });
   const data = await res.json();
   console.log(data);

   Python

   import os, httpx
   
   r = httpx.post(
       "https://api.cloudqube.eu/v1/email/send",
       headers={"Authorization": f"Bearer {os.environ['CLOUDQUBE_API_KEY']}"},
       json={
           "from": "hello@yourdomain.eu",
           "to": "you@example.com",
           "subject": "First email from CloudQube",
           "text": "Hello from your new email qube.",
       },
       timeout=10,
   )
   print(r.json())

5. Check your inbox

   The email arrives within seconds. If it lands in spam, see Email going to spam.

What gets billed

Every send is metered. The price per email is shown on the email qube’s dashboard. Bounces and complaints do not get billed beyond the initial send. There is no monthly fee.

What happens to bounces

Bounces are tracked automatically and added to your suppression list. The email qube exposes the list through the API so you can prune it from your contacts. See Handle bounces.