Documentation

Add professional support to your website in under 2 minutes.

Quick start

The fastest way to get started is the JS widget. Paste this before your closing </body> tag:

<script
  src="https://cdn.simplesupport.uk/widget.js"
  data-key="YOUR_API_KEY"></script>

Replace YOUR_API_KEY with the API key from your admin panel settings.

💡 Don't have an account? Create a free one — takes 30 seconds.

Create an account

Sign up at dashboard.simplesupport.uk. You'll get:

• Your API key (shown once — copy it)
• Access to the admin panel
• Free plan (100 tickets/month)

JS Widget

The widget adds a floating support button to your website. One line of code:

<script src="https://cdn.simplesupport.uk/widget.js" data-key="YOUR_API_KEY"></script>

Options

<script
  src="https://cdn.simplesupport.uk/widget.js"
  data-key="YOUR_API_KEY"
  data-position="bottom-right"
  data-lang="en"
  data-color="#4F46E5"
></script>

Custom colors with CSS

:root {
  --ss-primary: #your-color;
  --ss-radius: 8px;
}

WordPress

Two options:

Plugin (recommended — coming soon)

Install the SimpleSupport plugin from the WordPress plugin directory. Enter your API key in Settings → SimpleSupport.

Manual

Add to your functions.php or use a "Insert Headers and Footers" plugin:

function simplesupport_widget() {
    echo '<script src="https://cdn.simplesupport.uk/widget.js" data-key="YOUR_API_KEY"></script>';
}
add_action('wp_footer', 'simplesupport_widget');

HTML Embed

Embed the support form inline on a page using an iframe:

<iframe
  src="https://app.simplesupport.uk/embed/YOUR_API_KEY"
  width="100%"
  height="500"
  frameborder="0"
  title="Support"
></iframe>

Email Gateway

Available on Pro and Business plans. Customers open tickets by emailing support@yourcompany.com.

Setup

1. Go to Settings → Email Gateway in your panel
2. Add your support email address
3. Add the MX record shown to your DNS
4. Click "Verify" — takes up to 24h to propagate

REST API

Base URL: https://app.simplesupport.uk

All requests require: Authorization: Bearer YOUR_API_KEY

Create a ticket

POST /api/tickets

{
  "customer_email": "user@example.com",
  "customer_name": "Jane Smith",
  "subject": "Cannot access my account",
  "message": "I've tried resetting..."
}

List tickets

GET /api/tickets?status=open&limit=20

Reply to a ticket

POST /api/tickets/:id/messages

{ "body": "Hi Jane, let me help with that..." }

Update ticket status

PATCH /api/tickets/:id

{ "status": "resolved" }

For the full API reference, see api.md.