Skip to main content

Wix Marketing MCP Server

Create a powerful Model Context Protocol (MCP) server for Wix Marketing in minutes with our AI Gateway. This guide walks you through setting up seamless marketing automation integration with enterprise-grade security and instant OAuth authentication.

About Wix Marketing API​

Wix Marketing provides comprehensive marketing and automation capabilities for Wix sites. The Marketing API enables programmatic access to:

  • Marketing Automations: Create and manage workflow automations
  • Notifications: Send notifications to site owners and contributors
  • Coupons: Create and manage promotional discount codes
  • Email Marketing: Manage email campaigns, test, and publish
  • Marketing Consent: Track and manage GDPR-compliant consent
  • Marketing Tags: Configure analytics tags (GA, Facebook Pixel, GTM)

Key Features​

  • Automation Workflows: Trigger-based automated actions
  • Coupon Management: Percent off, money off, free shipping, fixed price
  • Email Campaigns: Create, reuse, test, and publish campaigns
  • Campaign Analytics: Track opens, clicks, bounces, and delivery
  • Consent Tracking: GDPR-compliant marketing consent management
  • Third-party Tags: Google Analytics, Facebook Pixel, Google Tag Manager
  • Site Notifications: Push notifications to Wix Owner app
  • Multi-channel Marketing: Integrated marketing across channels

What You Can Do with Wix Marketing MCP Server​

The MCP server transforms Wix Marketing API into a natural language interface, enabling AI agents to:

Marketing Automations​

  • Workflow Creation

    • "Create an automation workflow for new signups"
    • "Set up a triggered action for form submissions"
    • "Build a lead nurturing automation sequence"
    • "Configure automated follow-up workflows"

  • Workflow Management

    • "List all active automations on the site"
    • "Get details for a specific automation"
    • "Update automation status to inactive"
    • "Validate automation configuration"

  • Trigger Configuration

    • "Set up triggers based on customer actions"
    • "Configure event-based automation triggers"
    • "Link automations to form submissions"
    • "Create behavior-based trigger rules"

Coupon Management​

  • Coupon Creation

    • "Create a 20% off coupon code SUMMER20"
    • "Set up a $10 off coupon for orders over $50"
    • "Create a free shipping promotion code"
    • "Configure a fixed price sale coupon"

  • Coupon Queries

    • "List all active coupons"
    • "Find coupons expiring this month"
    • "Show coupon usage statistics"
    • "Get details for coupon code SAVE10"

  • Coupon Operations

    • "Update coupon expiration date"
    • "Deactivate the holiday sale coupon"
    • "Delete unused promotion codes"
    • "Modify coupon usage limits"

Email Marketing​

  • Campaign Management

    • "List all email campaigns"
    • "Get campaign details and status"
    • "Delete draft campaigns"
    • "Reuse a successful campaign template"

  • Campaign Actions

    • "Send a test email to marketing@company.com"
    • "Publish the newsletter campaign"
    • "Duplicate the welcome email for editing"
    • "Schedule campaign for next Tuesday"

  • Campaign Analytics

    • "Get statistics for recent campaigns"
    • "Track email open rates and clicks"
    • "Monitor bounce and delivery rates"
    • "Analyze campaign performance trends"

  • Consent Management

    • "Create email marketing consent for new subscriber"
    • "Update consent status to confirmed"
    • "Revoke marketing consent for user"
    • "Query consent records by email"

  • Consent Queries

    • "Find all confirmed consent records"
    • "List pending consent verifications"
    • "Check consent status for specific email"
    • "Export consent records for compliance"

  • GDPR Compliance

    • "Track consent confirmation dates"
    • "Record consent revocation activities"
    • "Maintain consent audit trail"
    • "Handle unsubscribe requests"

Marketing Tags​

  • Tag Configuration

    • "Add Google Analytics tracking ID"
    • "Configure Facebook Pixel for the site"
    • "Set up Google Tag Manager container"
    • "Enable Yandex Metrica tracking"

  • Tag Management

    • "List all configured marketing tags"
    • "Update Google Analytics to GA4"
    • "Disable Facebook Pixel temporarily"
    • "Remove unused tracking tags"

Notifications​

  • Site Notifications
    • "Send notification to site owner"
    • "Trigger notification from template"
    • "Include dynamic values in notification"
    • "Alert contributors about new activity"

Prerequisites​

  • Access to Cequence AI Gateway
  • Wix account with relevant apps installed
  • App development access in Wix
  • API credentials (Client ID and Secret)

Step 1: Create Wix App​

Before setting up the MCP server, you need to create an app in Wix.

1.1 Access Wix Developers​

  1. Navigate to dev.wix.com
  2. Sign in with your Wix account
  3. Go to My Apps in the developer dashboard

1.2 Create New App​

  1. Click Create New App
  2. Select Build from scratch
  3. Fill in app details:
    • App Name: "AI Gateway Marketing MCP"
    • Description: "MCP server for Wix Marketing automation"

1.3 Configure OAuth​

  1. Navigate to OAuth settings
  2. Add Redirect URL: 
    https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback
  3. Select required permissions for Marketing access

1.4 Get Credentials​

  1. Go to OAuth page
  2. Copy App ID
  3. Copy App Secret Key

Step 2: Access AI Gateway Apps​

  1. Log in to your Cequence AI Gateway dashboard
  2. Navigate to Apps in the left sidebar

Step 3: Find and Select Wix Marketing API​

  1. Browse the Third-party category
  2. Look for Wix Marketing
  3. Click on the API card to view details

Step 4: Create MCP Server​

Click Create MCP Server to start the wizard.

Step 5: Configure API Endpoints​

  1. Base URL: https://www.wixapis.com
  2. Select API endpoints to expose:
    • Automations (create, query, get, update, validate)
    • Notifications (notify)
    • Coupons (create, query, get, update, delete)
    • Email Marketing (list, get, delete, reuse, publish, test, statistics)
    • Marketing Consent (create, query, get, update, remove)
    • Marketing Tags (list, upsert)
  3. Click Next

Step 6: MCP Server Basic Setup​

  1. MCP Server Name: "Wix Marketing Automation"
  2. Description: "Marketing campaigns, coupons, and automation management"
  3. Production Mode: Toggle as needed
  4. Click Next

Step 7: Configure Authentication​

  1. Authentication Type: OAuth 2.0

  2. Fill in OAuth settings:

    • Authorization URL: 
      https://www.wix.com/installer/install
    • Token URL: 
      https://www.wixapis.com/oauth2/token
    • Client ID: Paste from Wix app
    • Client Secret: Paste from Wix app
    • Redirect URI: 
      https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback

  3. Required Headers:

    • Authorization: Bearer {access_token}
    • wix-site-id: {site_id}

Step 8: Configure Security​

  1. API Protection: Toggle ON to enable

    • Protects against bot attacks, DDoS, and threats
    • Monitors for suspicious activity
    • Rate limiting and anomaly detection

  2. Click Next

Step 9: Choose Deployment Method​

  • Fully managed deployment
  • Automatic scaling and monitoring
  • Built-in high availability

Option B: Deploy with Helm Chart​

  • Self-managed Kubernetes deployment
  • Full control over infrastructure

Click Next after selecting.

Step 10: Review and Deploy​

Review your configuration:

  • MCP Server Name: Your chosen name
  • Base URL: https://www.wixapis.com
  • Selected Endpoints: Marketing operations
  • Authentication: OAuth 2.0 (Configured)
  • API Protection: Enabled/Disabled

Click Create & Deploy to finalize.

Using Your Wix Marketing MCP Server​

Setup Instructions:

Common Use Cases​

Email Marketing​

  • Newsletter campaigns
  • Welcome email sequences
  • Promotional announcements
  • Re-engagement campaigns

Promotional Campaigns​

  • Discount code management
  • Seasonal sales promotions
  • Customer loyalty rewards
  • Flash sale automation

Marketing Automation​

  • Lead nurturing workflows
  • Customer onboarding sequences
  • Abandoned cart recovery
  • Event-triggered messaging

Analytics & Tracking​

  • Conversion tracking setup
  • Campaign performance monitoring
  • Customer behavior analytics
  • Marketing attribution

Security Best Practices​

  1. OAuth Security:

    • Secure credential storage
    • Regular token rotation
    • Minimal permission scopes
    • Monitor API usage

  2. Data Protection:

    • Marketing consent compliance
    • GDPR adherence
    • Secure data transmission
    • Audit logging

  3. Campaign Security:

    • Sender authentication
    • Spam compliance
    • Unsubscribe handling
    • List hygiene

Troubleshooting​

Common Issues​

  1. 401 Unauthorized

    • Verify access token validity
    • Check wix-site-id header
    • Ensure app is installed on site
    • Regenerate credentials if expired

  2. 404 Not Found

    • Verify campaign/coupon IDs exist
    • Check automation IDs are valid
    • Confirm consent records exist
    • Use query endpoints for lookups

  3. 400 Bad Request

    • Check required fields for coupons (scope.namespace)
    • Verify coupon type (only one of percentOff, moneyOff, etc.)
    • Validate startTime as Unix timestamp (milliseconds)
    • Ensure email addresses are valid format

  4. Email Marketing Errors

    • Verify email account is ACTIVE
    • Check sender verification status
    • Confirm monthly quota available
    • Validate recipient list exists

Getting Help​