Skip to main content

​
Overview

Alana Shopping integrates with e-commerce platforms and data providers to sync product data bidirectionally. Integrations use OAuth for secure authorization and support automatic sync schedules.

​
Connecting a platform

1

Authorize

Start the OAuth flow to connect your e-commerce account:
curl -X POST "https://app.alana.shopping/api/integrations/authorize" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": "shopify", "workspaceId": "ws_..."}'
This returns an authorization URL. Redirect the user to complete OAuth.
2

Callback

After authorization, the platform redirects to our callback URL with credentials that are stored securely.
3

Sync

Trigger an initial sync to pull products from the connected platform:
curl -X POST "https://app.alana.shopping/api/integrations/sync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId": "ws_...", "platform": "shopify"}'

​
Checking integration status

curl "https://app.alana.shopping/api/integrations/status" \
  -H "Authorization: Bearer YOUR_API_KEY"
Returns the connection status, last sync time, and any errors for each configured integration.

​
Sync monitoring

After triggering a sync, monitor its progress: 
curl "https://app.alana.shopping/api/integrations/sync/status" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
MCP Integration

For advanced integrations, Alana Shopping supports the Model Context Protocol (MCP):
  • Inbound — receive product batches via /api/mcp/inbound
  • Feed subscriptions — subscribe to product feeds via /api/mcp/feed/{platform}
  • Search — query across integrated sources via /api/mcp/search