Skip to main content

Connect an integration

Use this guide to connect the services available under Settings → Integrations: Email, WhatsApp, and Google Calendar. Each has its own section below, with related settings and the place to use the connection.

This topic covers the Integrations page at /user-profile-settings/integrations, linked from Settings → Integrations.

Who can do this​

Owners and Admins can access integration settings. Other users need the relevant Integrations permissions; viewing and editing are separate permissions. The available connection options also depend on the integration.

Before you begin​

  1. Confirm with your workspace Owner or Admin that the required service and access are available.
  2. Have admin access to the external account (Google Workspace, WhatsApp Business, SMTP credentials).
  3. Allow browser pop-ups for provider sign-in flows (Gmail, Outlook, Google Calendar).
  4. Know your plan limits—especially WhatsApp instances (connecting multiple numbers may require an upgrade).

In this guide​

Each integration shows its available connection options and status on this page. After connecting one, check the related Inbox channel, email feature, or Calendar.


Open Integrations​

  1. Open Settings (/settings).
  2. Under the Integrations card, select Email, WhatsApp, or Google Calendar (all route to the same page).
  3. Or navigate directly to /user-profile-settings/integrations.
  4. Review integration cards:
CardProviderEnables
EmailGmail, Outlook, or SMTPConnect an email account for supported workspace email features
WhatsAppWorkspace WhatsApp connectionWhatsApp conversations in Inbox
Google CalendarGoogleSchedule meetings, availability, invites

Each card shows the connection options available for that integration.


Connect Email​

Email provider options​

MethodBest for
Gmail (OAuth)Individual reps on Google Workspace or Gmail
Outlook (Microsoft 365 / Outlook.com)Sign in with a Microsoft email account
SMTPCustom mail servers, transactional providers, Mailgun-style SMTP

Procedure — Gmail​

  1. On Integrations, select Email → Connect.
  2. Choose Gmail (if prompted).
  3. Complete Google sign-in in the pop-up window.
  4. Grant permissions requested by SWS Agent.
  5. Return to Integrations—the Email card shows connected.

Procedure — Outlook​

  1. Select Email → Connect.
  2. Choose Outlook or the Microsoft sign-in option.
  3. Sign in to the Microsoft account and review the requested access.
  4. Return to Integrations and confirm the Email connection status.

Procedure — SMTP​

  1. Select Email → Connect → SMTP.
  2. Enter SMTP host, port, username, password, and from-address as shown.
  3. Save the connection. If the page offers a Test button, run it to check the settings.

Verify:

  • Email card status = connected
  • Open a Contact → send or log an email action
  • Check Inbox for sync (may take a few minutes on first connect)

Connect WhatsApp​

  1. Open Settings → Integrations and select WhatsApp.
  2. Review the connection options shown for your workspace and complete the available connection steps.
  3. Return to Integrations and check the WhatsApp connection status.
  4. To adjust how WhatsApp works across the workspace, open Communications settings.
  5. To create reusable WhatsApp messages, open Settings → Templates → WhatsApp Templates.
  6. To read and reply to conversations, open Inbox → WhatsApp.

If WhatsApp does not appear in Inbox, check the connection status and your Inbox channel access.


Connect Google Calendar​

  1. Select Google Calendar → Connect.
  2. Sign in with the Google account that should own meeting bookings.
  3. Grant calendar permissions.
  4. Return to Integrations—Calendar shows connected.

Verify:

  • Open Calendar (/calendar) and confirm events sync
  • Create a test booking link if you use Appointment types


After connecting — workspace checklist​

ChannelNext step
EmailEmail domains before bulk campaigns
WhatsAppCommunications settings and WhatsApp templates
CalendarAppointment types + Calendar links

Troubleshooting​

SymptomLikely causeFix
OAuth window closes instantlyPop-up blockerAllow pop-ups for SWS Agent domain
Wrong provider account connectedSigned into the wrong provider account in browserSign out of the provider and reconnect with the intended account
WhatsApp is missing from InboxChannel connection or accessCheck the WhatsApp status above and your Inbox channel access
Connected but Inbox emptySync delay or wrong folderWait 5–10 min; check Inbox folders
Microsoft sign-in failsWrong Microsoft account or access not grantedRetry with the intended Microsoft account and complete the consent prompt
SMTP auth failedWrong port/TLS or passwordVerify SMTP settings with IT

See also​