SeggWat LogoSeggWat
BlogDashboard

API Integration

Learn how to integrate SeggWat programmatically using the REST API.

Overview

The SeggWat API allows you to programmatically access and manage feedback data from your applications. This is useful for:

  • Backend integrations: Process feedback in your own systems
  • Custom dashboards: Build your own analytics and reporting tools
  • Automation: Trigger workflows based on feedback events
  • Data exports: Extract feedback for analysis or backup
  • Third-party integrations: Connect SeggWat to other tools in your stack

Prerequisites

Before you start, ensure you have:

  1. A SeggWat account with at least one project
  2. An Organization Access Token (API key) - see Authentication
  3. Your project ID (found in the dashboard under project settings)

Getting Started

1. Create an API Token

1

Navigate to Settings

Log in to your SeggWat Dashboard and click Settings in the sidebar.

2

Generate Token

Go to the API Tokens tab and click Create New Token. Optionally add a label like "Backend Integration" or "CI/CD Pipeline".

3

Store Securely

Copy the token immediately - it will only be shown once! Store it in your environment variables:

bash
export SEGGWAT_API_KEY=oat_xxxxxxxxxxxxxxxxxxxxx

2. Find Your Project ID

  1. Go to your project in the dashboard
  2. Click Settings in the project sidebar
  3. Copy the Project ID (UUID format)

Common Use Cases

List All Feedback

Retrieve a paginated list of feedback for a project:

curl -X GET "https://seggwat.com/api/v1/projects/YOUR_PROJECT_ID/feedback?page=1&limit=20" \
  -H "X-API-Key: $SEGGWAT_API_KEY"

Filter Feedback by Status

Get only new, unprocessed feedback:

curl -X GET "https://seggwat.com/api/v1/projects/YOUR_PROJECT_ID/feedback?status=New&limit=50" \
  -H "X-API-Key: $SEGGWAT_API_KEY"

Search Feedback by Content

Search for specific keywords in feedback messages:

curl -X GET "https://seggwat.com/api/v1/projects/YOUR_PROJECT_ID/feedback?search=bug" \
  -H "X-API-Key: $SEGGWAT_API_KEY"

Get Single Feedback Item

Retrieve detailed information about a specific feedback item:

curl -X GET "https://seggwat.com/api/v1/projects/YOUR_PROJECT_ID/feedback/FEEDBACK_ID" \
  -H "X-API-Key: $SEGGWAT_API_KEY"

Integration Examples

Slack Notification Bot

Send new feedback to a Slack channel:

javascript
const SEGGWAT_API_KEY = process.env.SEGGWAT_API_KEY;
const SLACK_WEBHOOK_URL = process.env.SLACK_WEBHOOK_URL;
const PROJECT_ID = process.env.SEGGWAT_PROJECT_ID;

async function sendNewFeedbackToSlack() {
  // Get new feedback
  const response = await fetch(
    `https://seggwat.com/api/v1/projects/${PROJECT_ID}/feedback?status=New&limit=10`,
    {
      headers: { 'X-API-Key': SEGGWAT_API_KEY }
    }
  );

  const data = await response.json();

  // Send each to Slack
  for (const feedback of data.feedback) {
    await fetch(SLACK_WEBHOOK_URL, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        text: `New ${feedback.type} feedback`,
        blocks: [
          {
            type: 'section',
            text: {
              type: 'mrkdwn',
              text: `*New ${feedback.type} Feedback*\n${feedback.message}`
            }
          },
          {
            type: 'context',
            elements: [
              {
                type: 'mrkdwn',
                text: `Path: ${feedback.path || 'N/A'} | Version: ${feedback.version || 'N/A'}`
              }
            ]
          }
        ]
      })
    });
  }
}

// Run every 5 minutes
setInterval(sendNewFeedbackToSlack, 5 * 60 * 1000);

CSV Export Script

Export feedback to a CSV file for analysis:

python
import csv
import requests
import os

SEGGWAT_API_KEY = os.getenv('SEGGWAT_API_KEY')
PROJECT_ID = os.getenv('SEGGWAT_PROJECT_ID')

def export_to_csv(filename='feedback.csv'):
    all_feedback = []
    page = 1

    # Fetch all pages
    while True:
        response = requests.get(
            f'https://seggwat.com/api/v1/projects/{PROJECT_ID}/feedback',
            headers={'X-API-Key': SEGGWAT_API_KEY},
            params={'page': page, 'limit': 100}
        )

        data = response.json()
        all_feedback.extend(data['feedback'])

        if page >= data['pagination']['total_pages']:
            break
        page += 1

    # Write to CSV
    with open(filename, 'w', newline='') as csvfile:
        fieldnames = ['id', 'message', 'type', 'status', 'source', 'created_at', 'path', 'version']
        writer = csv.DictWriter(csvfile, fieldnames=fieldnames)

        writer.writeheader()
        for feedback in all_feedback:
            writer.writerow({
                'id': feedback['id'],
                'message': feedback['message'],
                'type': feedback['type'],
                'status': feedback['status'],
                'source': feedback['source'],
                'created_at': feedback['created_at'],
                'path': feedback.get('path', ''),
                'version': feedback.get('version', '')
            })

    print(f"Exported {len(all_feedback)} feedback items to {filename}")

if __name__ == '__main__':
    export_to_csv()

GitHub Issue Creator

Automatically create GitHub issues from bug reports:

javascript
const SEGGWAT_API_KEY = process.env.SEGGWAT_API_KEY;
const GITHUB_TOKEN = process.env.GITHUB_TOKEN;
const PROJECT_ID = process.env.SEGGWAT_PROJECT_ID;
const GITHUB_OWNER = 'your-org';
const GITHUB_REPO = 'your-repo';

const octokit = new Octokit({ auth: GITHUB_TOKEN });

async function createIssuesFromBugs() {
  // Get bug-type feedback that's new
  const response = await fetch(
    `https://seggwat.com/api/v1/projects/${PROJECT_ID}/feedback?type=Bug&status=New`,
    {
      headers: { 'X-API-Key': SEGGWAT_API_KEY }
    }
  );

  const data = await response.json();

  for (const feedback of data.feedback) {
    // Create GitHub issue
    await octokit.issues.create({
      owner: GITHUB_OWNER,
      repo: GITHUB_REPO,
      title: `[User Feedback] ${feedback.message.substring(0, 60)}...`,
      body: `
## User Feedback

**Type:** ${feedback.type}
**Source:** ${feedback.source}
**Created:** ${feedback.created_at}
**Path:** ${feedback.path || 'N/A'}
**Version:** ${feedback.version || 'N/A'}

### Message

${feedback.message}

---
*Feedback ID: ${feedback.id}*
*View in SeggWat: https://seggwat.com/dashboard/feedback/${feedback.id}*
      `,
      labels: ['feedback', 'bug']
    });

    console.log(`Created GitHub issue for feedback ${feedback.id}`);
  }
}

createIssuesFromBugs();

Error Handling

Always handle API errors gracefully:

javascript
async function safeFetchFeedback() {
  try {
    const response = await fetch(
      `https://seggwat.com/api/v1/projects/${PROJECT_ID}/feedback`,
      {
        headers: { 'X-API-Key': SEGGWAT_API_KEY }
      }
    );

    if (!response.ok) {
      if (response.status === 401) {
        throw new Error('Invalid API key');
      } else if (response.status === 403) {
        throw new Error('Access denied to this project');
      } else if (response.status === 404) {
        throw new Error('Project not found');
      }
      throw new Error(`API error: ${response.status}`);
    }

    return await response.json();
  } catch (error) {
    console.error('Failed to fetch feedback:', error.message);
    return null;
  }
}

Rate Limits

The SeggWat API currently enforces the following rate limits:

  • Feedback endpoints: 20 requests per minute per IP
  • Health endpoints: 300 requests per minute per IP

If you exceed these limits, you'll receive a 429 Too Many Requests response.

Best Practices

Next Steps

API Reference

Complete API documentation with all available endpoints

List Feedback

Detailed documentation for the list feedback endpoint

Get Feedback

Detailed documentation for getting single feedback items

Submit Feedback

Learn how to submit feedback programmatically

Navigation