API Documentation
Premium Feature

PulseBack API

Integrate customer feedback and reputation data directly into your systems. Build custom dashboards, automate workflows, and unlock powerful integrations.

Secure Bearer Token Auth
RESTful JSON API
Webhook Support

Base URL

https://getpulseback-production.up.railway.app/api

Authentication

All API requests require a Bearer token in the Authorization header

// Include this header with every request
Authorization: Bearer <your_access_token>

Getting Your Access Token

import { createClient } from '@supabase/supabase-js'

const supabase = createClient(
  'https://mkpxnprhwzrnxbfbdbts.supabase.co',
  'your-anon-key'
)

// Sign in to get a session
const { data, error } = await supabase.auth.signInWithPassword({
  email: 'your@email.com',
  password: 'your-password'
})

// Use this token for API requests
const accessToken = data.session.access_token
GET
/feedback

Retrieve all feedback for your business

Query Parameters

status - Filter: new, reviewed, resolved
sentiment - Filter: positive, neutral, negative
limit - Results per page (default: 20, max: 100)
offset - Pagination offset
days - Limit to last N days

Example Request

const response = await fetch(
  'https://getpulseback-production.up.railway.app/api/feedback?status=new&limit=10',
  {
    headers: {
      'Authorization': 'Bearer ' + accessToken
    }
  }
)

const data = await response.json()

Response

{
  "feedback": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "created_at": "2026-02-07T12:00:00Z",
      "customer_name": "John Doe",
      "customer_email": "john@example.com",
      "rating": 4,
      "comment": "Great service, food was excellent!",
      "sentiment": "positive",
      "sentiment_score": 0.92,
      "themes": ["service", "food quality"],
      "status": "new",
      "source": "widget"
    }
  ],
  "total": 145,
  "limit": 10,
  "offset": 0
}
POST
/feedback

Create feedback programmatically (e.g., from POS integration)

Request Body

{
  "customer_name": "Jane Smith",      // optional
  "customer_email": "jane@email.com", // optional
  "customer_phone": "555-1234",       // optional
  "rating": 5,                        // required: 1-5
  "comment": "Amazing experience!",   // optional
  "source": "pos_integration"         // optional: widget, phone, email, pos_integration
}

Example: Toast POS Integration

// After a transaction completes in Toast
async function sendFeedbackRequest(order) {
  // Send SMS/Email to customer
  await fetch('https://getpulseback-production.up.railway.app/api/feedback', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer ' + accessToken,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      customer_name: order.customerName,
      customer_email: order.customerEmail,
      rating: 5, // They can adjust via link
      source: 'toast_integration'
    })
  })
}

Integration Examples

Zapier / Make Automation

Connect PulseBack to 5,000+ apps:

  • Send negative feedback to Slack instantly
  • Add happy customers to Mailchimp referral campaigns
  • Create Zendesk tickets for follow-up
  • Log feedback to Google Sheets

Custom Dashboard

Build internal reporting for stakeholders:

  • Aggregate multi-location data
  • Create investor reports
  • Build franchise owner dashboards
  • Integrate with BI tools (Tableau, Power BI)

POS Integration

Trigger feedback requests after transactions:

  • Square, Toast, Clover, Shopify
  • Automatic post-purchase SMS/email
  • Track feedback by transaction
  • Link revenue to satisfaction

White-Label Reselling

For marketing agencies and resellers:

  • Build branded dashboards for clients
  • Manage multiple businesses
  • Custom reporting with your branding
  • Bulk API operations

Rate Limits

Standard endpoints100 requests / minute
AI endpoints10 requests / minute
Strategic analysis5 requests / hour

Rate limit headers are included in all responses: X-RateLimit-Remaining, X-RateLimit-Reset

Need help with your integration? Contact our developer support team.

Contact API Support