Custom Integration (SDK)

Coming Soon - The TypeScript/JavaScript SDK is currently in development.

What to Expect

The Synoveo SDK will provide:

TypeScript support - Full type definitions for all API endpoints
Easy authentication - Handle API keys and OAuth tokens automatically
Webhook handling - Process real-time updates from Google
Rate limiting - Built-in request throttling and retry logic

Planned SDK Features

// Example usage (coming soon)
import { SynoveoClient } from '@synoveo/sdk';

const client = new SynoveoClient({
  apiKey: 'your-api-key',
});

// Sync business data
await client.sync.push({
  locationId: 'locations/123',
  data: {
    title: 'My Business',
    phoneNumbers: { primaryPhone: '+1-555-123-4567' },
    regularHours: { /* ... */ }
  }
});

// Listen for updates
client.webhooks.on('location.updated', (event) => {
  console.log('Location updated:', event.location);
});

Current REST API

While the SDK is in development, you can use the REST API directly:

Authentication

# Using API Key
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.synoveo.com/api/v1/google-business/locations

Sync Data

curl -X POST https://api.synoveo.com/api/v1/google-business/sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "My Business", ...}'

Use Cases

The API/SDK is ideal for:

Use Case	Example
Custom CMS	Sync from headless CMS (Sanity, Contentful, Strapi)
POS Systems	Update hours/services from point-of-sale
Booking Systems	Sync services from custom booking platforms
Multi-location	Manage 100+ locations programmatically
White-label	Build GBP management into your SaaS product