Getting started
SendKettle lets you collect email subscribers, write emails and send them to your lists. This guide takes you from your first login to your first sent campaign.
What you need
- The web address of your SendKettle. Ask the person who installed it.
- An account. On a fresh install there is a demo account (see below).
- Usually nothing for sending: when your SendKettle can send on its own, the provider list starts with Built in (nothing to set up). Only if you want your own account with a sending provider, such as Mailgun, Postmark, Amazon SES, SendGrid, Brevo or Resend, do you need its login. Any provider that offers SMTP works.
- Access to the DNS settings of the domain you send from, or the help of someone who has it.
Step 1: log in
- Open the address of your SendKettle. You see the login page.
- Enter your email and password.
- Tick Remember me if you want to stay logged in on this computer.
- Click Log in.
On a fresh install, the demo account is admin@example.com with the password password. Change both right away:
- Click your name at the bottom of the menu and then Profile. On a phone the menu is at the top of the screen and your name is at the top right.
- On Your profile, change Name and Email.
- Under Change password, enter the Current password (
password), a New password of at least 10 characters, and the same password again in Confirm new password. - Click Save.
- Open the email sent to your new address and click Confirm this address. Your login email changes only then; the old address gets a notice. Any email change needs the current password.
If a colleague invited you, open the invitation email and click Choose your password first. If you forgot your password, click Forgot your password? on the login page. The team and roles guide explains both.
Find your way around
The menu groups its items:
| Group | Item | What you do there |
|---|---|---|
| Dashboard | See your totals and your five latest campaigns. | |
| Search | Find anything, or start an action such as Create campaign. Also with / or Ctrl + K. | |
| Campaigns | Campaigns | Write, test, schedule and send emails. |
| Campaigns | Automations | Build emails that go out on their own. |
| Campaigns | Channels | Send text messages, social posts and postcards. |
| Audience | Audiences | Manage your lists and contacts. |
| Content | Templates | Reuse email designs you saved. |
| Content | Landing pages | Make a web page with a signup form. |
| Analytics | Reports | Compare the results of all your campaigns. |
| Analytics | Store | Your connected online store. |
Help and Support sit under the groups. Click your name at the bottom of the menu to open the profile menu with Profile, Log out and, for Admins and Owners, Users, Settings and Integrations.
In the Bento Rail theme the menu is a slim bar of icons with short labels. Click › next to your name to widen it; on a short screen the logo is left out so every item stays in view.
Settings sections
Admins and Owners find everything that changes how the account works under Settings. A row of sections sits at the top, and a section with more than one page shows its pages in a second row:
| Section | Pages |
|---|---|
| Account | General (default theme and language, reports, UTM codes, opens by country, summary emails), Workspaces, Production checklist |
| Email sending | Sending and company (sending provider, sender defaults, company details, send rate and time zone, test email, bounce webhooks), Domains, Channels |
| Team | Users (with campaign approval), API keys |
| Integrations | Webhooks, Zapier, online stores and other apps |
| Brand | Your brand kit |
| Security | Sign-in and two-factor, Spam protection, Audit log |
| AI | The AI assistant |
You only see the sections and pages your role may open. Sign-in and two-factor, the default theme and language and the AI assistant are shared by every workspace, so only installation admins see them.
Required fields and errors
A red * after a label marks a field you have to fill in. When something is missing or wrong, the message appears right under that field, the field gets a red border and the cursor jumps to the first one; screen readers read the message out. Messages from the server, such as "Enter at least one valid email address.", show under their field too, and in a list at the top of the page.
Step 2: set up sending and your company details
The Settings page has separate boxes. Each box has its own save button, so you can fill in one without the others.
Sending provider
When your SendKettle can send email on its own (the server's mail server, or the platform's sending service in the cloud), the Provider list starts with Built in (nothing to set up) and it is already selected. Leave it as it is: there are no keys or SMTP settings to fill in. The box says how your email goes out and what is still needed, such as a verified domain.
Do you want to send through your own account at a provider instead?
- Click your name at the bottom of the menu, then Settings.
- In the Sending provider box, pick your provider from the Provider list. For a known provider, SMTP host, Port and Encryption fill in for you.
- Log in to your provider's website and create SMTP credentials there.
- Paste the username into Username and the password or API key into Password / API key.
- Type your Current password and click Save sending provider.
When Built in is not in the list, the server only writes email to a log file. Then SendKettle sends nothing until you connect a provider, and Admins and Owners see a yellow banner at the top of every screen.
Sender defaults, company details, send rate
- In Sender defaults, fill in Default from email and Default from name, and if you like a Default reply-to email. Click Save sender defaults.
- In Company details, fill in Company or sender name and Postal address. Anti-spam laws require them, and SendKettle adds them to the bottom of every campaign. Click Save company details. This box never asks for provider settings.
- In Send rate and time zone, leave Max emails per minute at
0, or enter the limit of your provider's plan, and pick your Time zone. Click Save.
Send a test email
- In the Send a test email box, check the address in Send to and click Send test email.
- Open your inbox. If the test email arrived, sending works.
Next, ask whoever manages your domain to add the SPF, DKIM and DMARC records shown under Domains. Without them, many emails land in spam. The sending and deliverability guide explains each provider and each record.
Step 3: create your first audience
An audience is a list of contacts. Most people need only one.
- Click Audiences in the sidebar.
- Click Create audience.
- Fill in Audience name, for example "Newsletter".
- Fill in Default from name and Default from email. New campaigns for this audience start with these.
- The box Require double opt-in for signup forms is ticked for new audiences. Keep it ticked. New subscribers then confirm their address by email first, which keeps fake and mistyped addresses off your list.
- Tick Ask for GDPR marketing consent on signup forms if you need a consent checkbox, and check the Consent text.
- Click Save.
Now add people. You have three options:
- Click Add contact to type in one person.
- Open the Import tab to upload a CSV file.
- Open the Signup form tab to share a form where people sign up themselves.
Only add people who agreed to get email from you. The audiences and contacts guide explains all three.
Step 4: create and send your first campaign
- Click Campaigns in the sidebar, then Create campaign.
- Pick a starting point in the row of tabs at the top: Drag & drop (the default), Simple text, Newsletter, Product announcement or RSS digest. Templates you saved yourself appear here with a ★.
- In the Setup box, enter a Campaign name. Only your team sees it.
- Choose the Audience. Leave Segment on Entire audience and Only contacts tagged on Any tag to send to everyone.
- Check From name and From email.
- Write a Subject line and a short Preview text. Inboxes show the preview text after the subject.
- In the Content box, design your email. The email builder guide explains every block.
- Click Save. The page reloads and shows more options below the editor.
- In Send a test, check the address and click Send test. Look at the email in your own inbox.
- Click Preview & checklist. Fix anything marked with a red cross.
- Click Send now in the Ready? box and confirm. Or go back to the editor and use Schedule to send it later.
After sending, the campaign page turns into its report. Opens and clicks appear as people read your email. The reports guide explains every number.
Common problems
The campaign says "Sent" but nobody got it
SendKettle puts every email in a queue, and a background process called the queue worker sends them. If that process is not running, emails wait in the queue. Ask the person who runs your server to check it. The installation guide explains how to set it up.
Scheduled campaigns never go out
Scheduled campaigns, A/B test winners, automations and RSS campaigns need the scheduler, a background task that runs every minute. Ask the person who runs your server to check it.
Images or links in my email point to "localhost"
The server's APP_URL setting must be the public address of your SendKettle. Ask the person who runs your server to fix it.
I don't see Settings or Users
Only Admins and Owners see them. Ask an Admin or Owner to change your role, or to do this step for you.