Marketing & Website
Marketing Portal
Email campaigns and contact management in a dedicated app.
4 min readMarketing Portal
Overview
The Marketing Portal is a separate ServiceFlow app for email campaigns, contact lists, and marketing automation at scale. The main CRM links to it via SSO—configure lists in the portal, operational leads still live in ServiceFlow Leads.
How to access
- From ServiceFlow — Settings → Integrations → Marketing Portal or Settings → Marketing Campaigns (open portal button when provisioned)
- Direct URL — your deployed marketing portal origin (e.g. configured via
VITE_MARKETING_PORTAL_URLin production)
Local development default:
http://localhost:5178What you can do today
- Provision a marketing workspace for your business (admin action in Integrations).
- Open portal with one-click SSO (
/auth/marketing-portal-tokenhandoff). - Build email campaigns and manage marketing contacts in the dedicated UI.
- Complement in-app Marketing Automation for operational lead nurture.
Prerequisites
- Admin enables marketing integration and provisions workspace.
- Marketing API and portal deployed for your environment (production URLs set in deploy config).
MARKETING_SERVICE_API_KEYand related secrets configured on API (hosting team).
Step-by-step
Provision workspace (admin)
- Settings → Integrations → Marketing Portal.
- Click Provision workspace (or equivalent).
- Wait for success confirmation.
Open the portal
- From Integrations or Marketing Campaigns, click Open Marketing Portal.
- New tab opens with SSO login token.
- Create lists, campaigns, and templates in the portal app.
Align with CRM leads
- Capture leads in ServiceFlow via widgets, intake, or integrations.
- Sync or export segments per portal capabilities—confirm with your admin which direction is enabled.
Current limitations
- External app — not embedded fully in main ServiceFlow UI (iframe/embed may exist on some settings pages but primary UX is separate tab).
- Contact model may differ from ServiceFlow customers—dedupe rules are manual unless sync jobs are configured.
- Advanced automation graphs live in portal, not in main Leads → Nurture View.
- Requires separate deployment and monitoring from core web/API.
Roadmap
- Bi-directional contact sync with ServiceFlow customers.
- Campaign attribution on estimate win reports.
- Single sign-on profile picker for multi-brand agencies.