Connect your accounts
Everything in Marketing runs on your own accounts. Open the app, click Connectors in the sidebar (top, under Dashboard) — every login lives on that one screen. Follow the section for each service you want to turn on.
Account & sign-in Built in
Email, guest, and Sign in with Apple work out of the box — no setup needed. Your account and settings live only on this Mac.
Google sign-in You log in
- Go to
console.cloud.google.com→ APIs & Services → Credentials. - Create credentials → OAuth client ID → Application type: Desktop app. (A Web client ID will not work.)
- Copy the client ID (ends in
.apps.googleusercontent.com) and paste it into Connectors → Google sign-in, then Save client ID. - On the sign-in screen, click Sign in with Google and complete the Google login in the window that opens.
The client ID only enables the button; you complete the actual Google login yourself. No client secret is required.
Lead Database Paste key
- Get your subscription key from your Black Label account.
- Paste it into Connectors → Lead Database → Subscription key and click Save key.
- The status chip turns to Connected and full listed contacts unlock (without a key you see a masked preview).
Mailboxes — sending & replies Paste key
Connect one or more of your own sending mailboxes. Outreach, sequences, spotlights, and newsletters all send from these.
- In Connectors → Mailboxes, click Add mailbox.
- Enter: From name, From email, SMTP host, port (usually
465), username (your email), and your mailbox app password (not your login password — generate one in your mail provider). - Click Test connection. Success shows “Connected and signed in to …”. If it fails, the app shows the exact reason (wrong app password, host, or port).
- To detect replies, enable Inbox (IMAP) on the same mailbox: IMAP host, port
993, same username/app password → Test connection.
Common hosts: Gmail smtp.gmail.com / imap.gmail.com · privateemail smtp.privateemail.com / imap.privateemail.com. Gmail requires an App Password with 2-factor enabled.
Newsletters — automated via Cloudflare One-time deploy
Newsletters send automatically on the cadence you set, through your own Cloudflare Email Worker (not a third-party service).
- Deploy the included worker once: in
cloudflare/newsletter-worker, runwrangler deploy, enable email sending, and set your secret withwrangler secret put(see that folder's README). - In Connectors → Newsletters, paste your worker endpoint, the From address, and the shared secret → Save.
- Turn on Auto-send. Due newsletters now fire automatically; Send now sends immediately.
CRM · Phone · Enrichment · Analytics Optional
These are bring-your-own-key connectors. Add a provider key where you have one:
- CRM (Salesforce / HubSpot / Pipedrive) — paste your API token to sync leads.
- Phone (Twilio / Telnyx) — add Account SID, Auth Token, and a from-number to enable click-to-call.
- Enrichment (Hunter / Apollo / Clearbit) — paste an API key for bulk email/phone enrichment.
- Analytics (GA4 / Google Ads / Meta Ads) — add your account IDs to label your configured sources.
Each shows a clear status: Connected, Off, or “not yet available.” Leaving one empty simply keeps that feature off — nothing breaks.
Questions, answered
What IMAP and SMTP settings do I use for a privateemail mailbox?
Use imap.privateemail.com for the inbox and smtp.privateemail.com for sending. Enable Inbox (IMAP) on the same mailbox with port 993 and the same username and app password, then click Test connection. For sending, the port is usually 465 and the username is your email.
Which password do I enter when I add a mailbox?
Enter your mailbox app password, not your login password. You generate the app password in your mail provider, and Gmail requires an App Password with 2-factor enabled. If the connection test fails, the app shows the exact reason, such as a wrong app password, host or port.
How do I set up Google sign-in in the Marketing app?
In console.cloud.google.com, open APIs & Services, Credentials and create an OAuth client ID with the application type Desktop app; a Web client ID will not work. Paste the client ID into Connectors, Google sign-in and save it, then click Sign in with Google and finish the login yourself. No client secret is required.
Where does the Marketing app store my keys and passwords?
On your Mac. The app ships empty and stores your keys and passwords locally, in the macOS Keychain and on-device settings. Your account and settings live only on that Mac, and everything in Marketing runs on your own accounts.
How do automated newsletters send?
Newsletters send on the cadence you set through your own Cloudflare Email Worker, not a third-party service. Deploy the included worker once with wrangler deploy, enable email sending and set your secret, then paste the worker endpoint, From address and shared secret into Connectors, Newsletters and turn on Auto-send.
Can I connect TikTok like the other social accounts?
Not through a desktop sign-in. TikTok posting is handled through the phone relay, so it appears separately. Instagram, X, Facebook, Threads, LinkedIn and YouTube connect through their own official sign-in, and each token is stored only on your Mac.
Social accounts You log in
Instagram, X, Facebook, Threads, LinkedIn, and YouTube connect through their own official sign-in — you authorize with your real account, and the token is stored only on your Mac.
TikTok posting is handled through the phone relay (there is no desktop sign-in), so it appears separately.