Documentation

Installing Synton AI

Create your account at [app.synton.ai](https://app.synton.ai/register). No credit card required.

Connect your store. Synton AI is platform-agnostic and works with Shopify, WooCommerce and Magento — choose your platform and authorize the connection.

Authorize the required permissions:

- Read/write products - Read orders and analytics - Read customer data

Complete the setup which will:

- Connect to your store - Analyze your product catalog - Deploy your AI agents

Choose your plan based on your needs:

- Starter Stores: from $49/mo for 10,000 credits - Growing Stores: from $199/mo for 45,000 credits (most popular) - Scaling Stores: up to $1,499/mo for 390,000 credits - Enterprise: custom credits, plus SAML SSO, a custom SLA and a dedicated success manager

Every paid plan includes all 151 AI agents, every feature module and priority support. Signing up is free — no credit card. Explore the platform, then pick a plan when you're ready to put the agents to work.

Connecting Your Store

Once you authorize the connection, Synton links to your store on Shopify, WooCommerce or Magento. Here's what happens:

Automatic Setup

Your store domain is registered with our system

Product catalog is indexed for AI recommendations

AI agents are initialized for your store

Verification

You can verify the connection by:

Opening Synton (app.synton.ai, or the Shopify admin if that is how you connected)

Checking the dashboard shows your store name

Asking the AI "Show my store info"

Troubleshooting

If connection fails:

Ensure you've granted all required permissions

Try reinstalling the app

Contact support if issues persist

Your First Conversation with Synton AI

Synton AI uses natural language to help you manage your store. Here are some example conversations:

Product Management

"Create a new product called Summer Collection Tee"

"Update all product prices by 10%"

"Show me products with low inventory"

AI Agents

"What's my Inventory Agent detecting?"

"Show me Pricing Agent recommendations"

"Run the SEO Agent on my product descriptions"

Analytics

"What were my sales last month?"

"Show me my best-selling products"

"Compare this week to last week"

Modules

"Enable the Reviews module"

"Configure cart abandonment emails"

"Show me my loyalty program stats"

Tips for Best Results

Be specific about what you want

Reference actual product names

Review agent recommendations before applying

Understanding AI Credits

Synton AI uses a credit system to track AI usage. Here's how it works:

What Are Credits?

Credits are the usage currency of Synton AI. Every piece of work an agent does — a chat turn, a product rewrite, an image, a full store audit — costs credits. Each plan includes a monthly credit allowance:

PlanPriceMonthly Credits

Starter Stores$49/mo10,000 Starter Stores$89/mo19,000 Starter Stores$149/mo32,500 Growing Stores$199/mo45,000 (most popular) Growing Stores$299/mo70,000 Growing Stores$449/mo108,000 Scaling Stores$649/mo160,000 Scaling Stores$999/mo250,000 Scaling Stores$1,499/mo390,000 EnterpriseCustomCustom

Every paid plan includes all 151 AI agents and every feature module, plus priority support. Enterprise adds a dedicated success manager, a custom SLA, SAML SSO, Managed Autopilot, and a security review with DPA.

How Credits Are Used

Everything is metered in credits:

Chat: roughly 15–20 credits per turn

Deep work: a full store audit runs to hundreds of credits

Email: 10 emails per credit

Media and agent runs: priced by the work performed

Two things keep your balance going further:

Failed actions are never billed. If an action doesn't complete, you don't pay for it.

Smart caching makes repeated operations cost less than the first run.

Monitoring Usage

Go to Settings > Usage in the app

View your current credit balance

See breakdown by feature

Rollover

Unused credits roll over at 50% into the next month.

What Happens When Credits Run Out?

Buy a top-up: mini — $5 for 500 credits, plus — $10 for 1,200 credits, pro — $25 for 3,500 credits

Or upgrade to a larger plan for a bigger monthly allowance

Trying Synton

Signing up is free — no credit card required. Connect your store and explore every app and your data. AI actions run once you're on a plan or have topped up: every action shows its credit price before it runs, and failed actions are never billed.

AI Agents Overview

Synton AI includes 151 AI agents. 19 of them run on a nightly sweep of your store; the rest run when you or a workflow call them.

Agents analyse and propose. They do not change your store by themselves: a proposal becomes a change when you approve it, or when you ask for it in chat, and Synton then executes it and records a receipt.

Business Intelligence Agents

Analytics Agent: Performance reports, anomaly detection

Benchmark Agent: Competitor monitoring

Customer Agent: Segmentation, churn prediction

Operations Agents

Inventory Agent: Stock forecasting, reorder alerts

Shipping Agent: Fulfillment optimization

Returns Agent: Pattern analysis

Marketing Agents

SEO Agent: Rank in Google and AI search engines

Social Agent: Social listening

Email Agent: Campaign optimization

Review Agent: Reputation management

Optimization Agents

Pricing Agent: Dynamic pricing recommendations

Conversion Agent: CRO insights

Personalization Agent: Product recommendations

Agent Approval Workflow

Agents generate recommendations that you can approve or dismiss.

How It Works

Agent analyzes your store data

Generates actionable recommendations

You review and approve/dismiss

Approved changes are applied

Approval Settings

"Show me pending agent approvals"

"Auto-approve Pricing Agent for changes under 5%"

"Require approval for all inventory changes"

Bulk Actions

"Approve all SEO recommendations"

"Dismiss outdated suggestions"

"Show me what each agent changed this week"

Agent Scheduling

Configure when and how often agents run.

Default Schedule

Overnight sweep: every night, across stock, SEO, product copy, speed, checkout and abandoned carts

Everything else runs when you or a workflow call it

Custom Scheduling

"Run Inventory Agent every 2 hours"

"Schedule Pricing Agent for midnight"

"Pause the Social Agent until next week"

Manual Triggers

"Run all agents now"

"Check inventory immediately"

"Generate a fresh SEO report"

Agent Reports

Get insights into what your agents are doing.

Weekly Summary

Every Monday, receive a summary of:

What each agent found, and what you approved

Revenue impact estimates

Recommendations pending approval

On-Demand Reports

"What did Pricing Agent do this week?"

"Show me Inventory Agent alerts"

"Generate a monthly agent performance report"

Metrics Tracked

Tasks completed

Recommendations generated

Approval rate

Estimated revenue impact

Creating Products

Create products using natural language with Synton AI.

Basic Product Creation

"Create a product called 'Summer Dress' priced at $59"

"Add a new t-shirt with sizes S, M, L, XL"

With Full Details

`` Create a product:

Title: Organic Cotton Tee

Price: $35

Compare at price: $45

Description: Sustainable comfort

Tags: organic, cotton, sustainable

Variants: S, M, L, XL

``

Product Images

"Add these images to the product" (drag & drop supported)

"Generate a product mockup for the t-shirt"

Tips

Use consistent naming conventions

Add SEO-friendly descriptions

Tag products for easy filtering

Bulk Product Updates

Update multiple products at once with Synton AI.

Price Updates

"Increase all prices by 10%"

"Set all t-shirts to $29.99"

"Apply a 20% discount to clearance items"

Inventory Updates

"Set all inventory to 100 units"

"Mark all products as 'Track inventory'"

Tag Management

"Add 'sale' tag to all products under $50"

"Remove 'new' tag from products older than 30 days"

Collection Updates

"Add all dresses to the Summer collection"

"Remove out-of-stock items from the homepage"

Safety Features

Preview changes before applying

Confirm bulk operations

Automatic rollback on errors

Inventory Management

Track and manage inventory levels with AI assistance.

Checking Inventory

"Show products with less than 10 in stock"

"What's my inventory value?"

"List out-of-stock products"

Updating Inventory

"Set Summer Dress inventory to 50"

"Add 20 units to all t-shirts"

"Mark Winter Coat as out of stock"

Inventory Alerts

"Alert me when any product goes below 5 units"

"Show me slow-moving inventory"

Multi-Location

"Show inventory by location"

"Transfer 10 units from Warehouse to Store"

AI Product Descriptions

Generate compelling product descriptions automatically.

Generating Descriptions

"Write a description for the Summer Dress"

"Create SEO-optimized descriptions for all products"

"Rewrite this description to be more engaging"

Style Options

Professional

Casual/Friendly

Luxury

Technical

Bulk Generation

"Generate descriptions for all products without one"

"Update all descriptions to include material info"

Best Practices

Review AI-generated content

Add unique brand voice

Include relevant keywords

Keep mobile readability in mind

Sales Reports

Get instant insights into your store's performance.

Quick Reports

"Show me today's sales"

"What were my sales last month?"

"Compare this week to last week"

Detailed Analysis

"Break down sales by product category"

"Show average order value trend"

"What's my conversion rate?"

Export Options

"Export sales data to CSV"

"Email me the monthly report"

Scheduled Reports

"Send me weekly sales summaries"

"Create a monthly performance report"

Customer Analytics

Understand your customers better with AI-powered insights.

Customer Overview

"How many customers do I have?"

"Show me repeat customer rate"

"What's customer lifetime value?"

Segmentation

"Show me high-value customers"

"Who are my most frequent buyers?"

"Find customers who haven't ordered in 90 days"

Behavior Analysis

"What products do customers buy together?"

"When do customers typically order?"

"What's the average time between orders?"

Traffic Sources

Analyze where your visitors come from.

Traffic Overview

"Where does my traffic come from?"

"Show me traffic trends this month"

"Compare organic vs paid traffic"

Source Analysis

"Which social platform drives most sales?"

"What's my Google search traffic?"

"Show referral sources"

Recommendations

"How can I increase organic traffic?"

"Which channels should I focus on?"

AI Recommendations

Get proactive suggestions to improve your store.

Automatic Insights

Synton AI analyzes your store and provides:

Sales optimization tips

Inventory recommendations

Marketing suggestions

UX improvements

Asking for Advice

"How can I increase sales?"

"What products should I discount?"

"How can I reduce cart abandonment?"

Implementation

"Apply the recommended changes"

"Show me the potential impact"

"Schedule this optimization"

Creating Discount Codes

Create and manage discount codes with natural language.

Basic Discounts

"Create a 20% off code called SAVE20"

"Make a free shipping code"

"Create a $10 off code for orders over $50"

Advanced Options

`` Create a discount:

Code: VIP50

Type: Percentage

Value: 50%

Minimum purchase: $100

Usage limit: 100 uses

Expires: End of month

``

Managing Discounts

"Show all active discount codes"

"Deactivate the SUMMER20 code"

"How many times was VIP50 used?"

Shipping Settings

Configure shipping rates and options.

Viewing Settings

"Show my shipping rates"

"What's my free shipping threshold?"

Updating Settings

"Add free shipping for orders over $75"

"Create a flat rate of $5 for domestic shipping"

Note: Some shipping settings require direct Shopify admin access.

Multi-Market Setup

Sell internationally with market-specific settings.

Market Overview

"Show me my active markets"

"What currencies do I support?"

Configuration

"Add UK market with GBP pricing"

"Set up EU market with VAT included"

Translations

"Translate product descriptions to French"

"Show me missing translations"

Checkout Customization

Customize the checkout experience.

Available Customizations

"Add a gift message field to checkout"

"Show trust badges on checkout"

"Customize the thank you page"

Checkout Extensions

Synton can help deploy checkout UI extensions:

Order tracking info

Upsell suggestions

Loyalty points display

Note: Some checkout customizations require Shopify Plus.

Custom Integrations

Connect Synton with your existing tools.

Available Integrations

Meta Ads: Optimize campaigns with AI

Google Ads: Performance management

TikTok Ads: Creative optimization

Email Marketing: Campaign automation

Setting Up

Go to Settings > Integrations

Connect your accounts

Configure sync options

API Integration

Use our API to build custom integrations with your internal tools.

REST API

Read your catalogue, run agents, pull analytics and approve changes over HTTP.

The full reference lives at [/docs/api](/docs/api) — every endpoint, its parameters, its responses, and the authentication and rate-limit contract. It is generated from the API's own OpenAPI document, so it describes what the server actually serves.

The short version

Base URL: https://app.synton.ai/api/v1

Authenticate with X-API-Key, or Authorization: Bearer if your client prefers it

Create a key in the dashboard under Settings > Advanced > Developer

120 requests per minute, per key

Webhooks

Receive real-time notifications from Synton.

Available Webhooks

task.completed: AI task finished

approval.required: Change needs approval

usage.threshold: Credit usage alert

module.event: Module-specific events

Setting Up

Go to Settings > Webhooks

Add your endpoint URL

Select events to receive

Payload Example

``json { "event": "task.completed", "timestamp": "2024-01-15T10:30:00Z", "data": { "taskId": "task_123", "type": "agent_recommendation", "status": "success" } } ``

MCP Server Setup

Use Synton AI from your IDE with Model Context Protocol.

What is MCP?

MCP (Model Context Protocol) allows AI assistants to interact with external tools and services.

Installation

Nothing to install: Synton runs a hosted MCP server. Point your client at it. ``bash claude mcp add synton --transport http https://mcp.synton.ai `

With an API key from app.synton.ai/api-settings: `bash claude mcp add synton --transport http https://mcp.synton.ai --header "Authorization: Bearer YOUR_API_KEY" `

Configuration

For a client that reads a JSON config, add the server by URL: `json { "mcpServers": { "synton": { "type": "http", "url": "https://mcp.synton.ai", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``

Without a key, the first call starts an OAuth sign-in, and a new session is read-only until you grant more. The URL carries no path — https://mcp.synton.ai/mcp is a 404.

Available Tools

Read store data

Queue product and content changes for approval

Run an agent and read what it found

Read analytics