Skip to main content

Wix CRM MCP Server

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

About Wix CRM API​

Wix CRM provides comprehensive customer relationship management capabilities for Wix sites. The CRM API enables programmatic access to:

  • Contact Management: Create, update, and manage contacts with custom fields
  • Member Management: Handle site members with authentication profiles
  • Labels & Segmentation: Organize contacts with labels and tags
  • Activity Tracking: Log and track customer interactions
  • Search & Query: Find contacts and members with advanced filtering
  • Merge Operations: Deduplicate and consolidate contact records

Key Features​

  • Unified Contact Database: Centralized customer information
  • Member Authentication: Site login and profile management
  • Custom Fields: Extended contact properties
  • Label System: Flexible contact categorization
  • Activity History: Interaction tracking and logging
  • Contact Sources: Track how contacts were acquired
  • Merge Capabilities: Combine duplicate records
  • Bulk Operations: Efficient mass data handling

What You Can Do with Wix CRM MCP Server​

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

Contact Management​

  • Contact Creation

    • "Create a contact for John Doe with email john@example.com"
    • "Add a new lead with company and job title"
    • "Import contact with full address information"
    • "Create contact with multiple email addresses"

  • Contact Queries

    • "List all contacts with pagination"
    • "Search contacts by email domain"
    • "Find contacts with VIP label"
    • "Show contacts created this week"

  • Contact Updates

    • "Update contact email address"
    • "Change company information for contact"
    • "Update job title to Senior Developer"
    • "Add phone number to existing contact"

  • Contact Search

    • "Search for contacts named John"
    • "Find contacts by company name"
    • "Search across all contact fields"
    • "Look up contact by phone number"

Member Management​

  • Member Creation

    • "Create a new member with login email"
    • "Register member with approved status"
    • "Set up member profile with nickname"
    • "Create member linked to existing contact"

  • Member Queries

    • "List all approved members"
    • "Find member by login email"
    • "Show pending member registrations"
    • "Get member profile details"

  • Member Operations

    • "Update member profile information"
    • "Block member account"
    • "Change member status to approved"
    • "Delete member registration"

Label Management​

  • Label Operations

    • "Create a new VIP Customer label"
    • "List all contact labels"
    • "Add labels to a contact"
    • "Remove label from contact"

  • Segmentation

    • "Find contacts by label"
    • "Create segments for marketing"
    • "Organize contacts into groups"
    • "Build targeted contact lists"

Contact Merging​

  • Merge Operations
    • "Merge duplicate contacts"
    • "Combine contact records by email"
    • "Consolidate customer information"
    • "Clean up duplicate entries"

Activity Tracking​

  • Activity Logging

    • "Log a note for the contact"
    • "Record a phone call activity"
    • "Track customer interaction"
    • "Add activity to contact history"

  • Activity Queries

    • "View contact activity history"
    • "Show recent interactions"
    • "Track engagement timeline"
    • "Generate activity report"

Data Management​

  • Bulk Operations

    • "Export contacts for reporting"
    • "Update multiple contact records"
    • "Apply labels to contact groups"
    • "Clean up inactive contacts"

  • Data Quality

    • "Find contacts with missing emails"
    • "Identify duplicate records"
    • "Validate contact information"
    • "Audit contact data completeness"

Prerequisites​

  • Access to Cequence AI Gateway
  • Wix account with CRM access
  • 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 CRM MCP"
    • Description: "MCP server for Wix CRM 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 CRM 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 CRM API​

  1. Browse the Third-party category
  2. Look for Wix CRM
  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:
    • Contacts (create, query, search, get, update, delete, merge)
    • Members (create, query, get, update, delete)
    • Labels (list, create, add to contact)
    • Activities (create)
  3. Click Next

Step 6: MCP Server Basic Setup​

  1. MCP Server Name: "Wix CRM Manager"
  2. Description: "Contact and member relationship 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: CRM operations
  • Authentication: OAuth 2.0 (Configured)
  • API Protection: Enabled/Disabled

Click Create & Deploy to finalize.

Using Your Wix CRM MCP Server​

Setup Instructions:

Common Use Cases​

Lead Management​

  • Lead capture and tracking
  • Lead qualification workflows
  • Lead assignment automation
  • Lead nurturing sequences

Customer Database​

  • Centralized contact management
  • Customer profile enrichment
  • Custom field configuration
  • Contact history tracking

Member Portal​

  • Member registration automation
  • Profile management
  • Access control
  • Member communications

Data Operations​

  • Contact deduplication
  • Data import/export
  • List segmentation
  • Bulk updates

Security Best Practices​

  1. OAuth Security:

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

  2. Data Protection:

    • Customer data privacy
    • GDPR compliance
    • Secure transmission
    • Audit logging

  3. Access Control:

    • Role-based permissions
    • Contact access restrictions
    • Member data protection
    • Session management

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 contact/member IDs exist
    • Check label keys are valid
    • Confirm resources are accessible
    • Use query endpoints for lookups

  3. 400 Bad Request

    • Check required contact info structure
    • Verify email format is valid
    • Include revision for updates
    • Validate phone number format

  4. 409 Conflict

    • Check revision number matches
    • Handle duplicate email conflicts
    • Verify merge operation targets
    • Refresh and retry operation

Getting Help​