Start here

# Quickstart

Connect your application and send a first email.

## Prepare your account

[Create account](https://usesendy.com/signup)

1.  ### Add a sending domain
    
    Open [Domains](https://usesendy.com/domains) and add a domain you control. Sending-account setup runs in the background.
    
2.  ### Publish the DNS records
    
    For Cloudflare-hosted DNS, use **Automatic setup** to review and approve the records in Cloudflare. You can also import a DNS file or add records manually with your provider. Keep them published and wait for **Verified**. Progress updates automatically.
    
3.  ### Create an API key
    
    Create a key in [API keys](https://usesendy.com/keys). Copy the full value when it appears; it is shown only once. Keep it on your application server.
    

If a domain needs approval or belongs to another account, contact support.

## Connect a domain with Cloudflare

If Cloudflare hosts your DNS, Sendy supports automatic record setup through Domain Connect. You need access to the domain’s zone in Cloudflare to review and approve the changes.

1.  Open your domain in [Domains](https://usesendy.com/domains).
2.  Choose **Automatic setup**, then select **Continue to Cloudflare**.
3.  Sign in to Cloudflare, review the three DKIM CNAME records, and approve the changes.
4.  Return to Sendy and select **Check verification**. Wait for **Verified** before sending. Keep the records published.

Cloudflare approval publishes the records; Sendy still checks DNS before verifying your domain. Verification can take up to 72 hours.

### Set up an optional custom return address

After domain verification, select **Set up return address**. Choose a dedicated subdomain such as `bounces.example.com` that does not host mail or another service, then select **Configure return address**. In **Connect your return address**, use **Automatic setup** to approve the MX record and SPF update in Cloudflare. Return to Sendy and select **Check verification** until both checks succeed. This is a separate approval from DKIM setup and is optional for sending.

If automatic setup is unavailable or you cancel approval, choose **Import a file** or **Add manually**. Keep DKIM CNAME records set to **DNS only** in Cloudflare; turn off **Proxy imported DNS records** when importing. See [domain verification troubleshooting](https://usesendy.com/docs/troubleshooting) if the domain stays pending.

## Add email credits

After domain verification, you get a one-time allowance of 50 test emails. Buy more credits from your wallet when you need them. Ksh 50 buys 1,000 email credits; purchased credits do not expire.

1.  Open [Wallet](https://usesendy.com/wallet) from the sidebar and choose **Fund wallet**.
2.  Enter a whole-shilling amount and your M-Pesa number, then approve the prompt on your phone.
3.  Wait for payment confirmation. The open funding form updates when payment is received. Choose **Check payment status** if you need to check again.
4.  Choose **Buy credits** in Wallet. Review the quote and confirm the purchase to turn wallet funds into email credits.

Funding adds money to your wallet. Buying credits is a separate step. See money added and spent in [Transactions](https://usesendy.com/transactions), and check your email credits in [Email credits](https://usesendy.com/billing).

Wait three minutes between payment requests. If you start another request too soon, the funding form shows the remaining minutes and seconds. If a request is uncertain, check the existing payment before starting another.

## Choose your integration

[

HTTP APISubmit JSON with plain text, HTML, or both. Get a job ID to track the request.

](https://usesendy.com/docs/api/send-email)[

SMTPUse your mail library with STARTTLS. Send MIME messages and attachments with the same API key.

](https://usesendy.com/docs/smtp)

## Use your framework or platform

*   [
    
    NodemailerSend plain-text and HTML email from your Node.js application.
    
    ](https://usesendy.com/docs/integrations/nodemailer)
*   [
    
    Email SDKSend email with @opencoredev/email-sdk through Sendy’s SMTP server.
    
    ](https://usesendy.com/docs/integrations/email-sdk)
*   [
    
    LaravelConnect Laravel’s mailer to Sendy over SMTP.
    
    ](https://usesendy.com/docs/integrations/laravel)
*   [
    
    DjangoConfigure Django’s SMTP backend and send multipart email.
    
    ](https://usesendy.com/docs/integrations/django)
*   [
    
    RailsConnect Action Mailer to Sendy for your Rails application.
    
    ](https://usesendy.com/docs/integrations/rails)
*   [
    
    PHPMailerSend email from PHP with an authenticated SMTP transport.
    
    ](https://usesendy.com/docs/integrations/phpmailer)
*   [
    
    WordPressConfigure site email with the WP Mail SMTP plugin.
    
    ](https://usesendy.com/docs/integrations/wordpress)
