Integrations

Connect external services to enhance your travel planning experience.

List Integrations

Get all available integrations.

Endpoint: GET /api/integrations

Response:

[
  {
    "id": "shopping",
    "name": "Shopping",
    "description": "Flight and hotel search",
    "connected": true
  },
  {
    "id": "google-calendar",
    "name": "Google Calendar",
    "description": "Sync events to calendar",
    "connected": false
  }
]

Get Integration Status

Check connection status for a specific integration.

Endpoint: GET /api/integrations/{integrationId}

Response:

{
  "id": "shopping",
  "name": "Shopping",
  "connected": true,
  "connectedAt": "2024-01-15T10:00:00Z",
  "capabilities": ["flight-search", "hotel-search"]
}

Connect Integration

Initiate OAuth flow or API key connection.

Endpoint: POST /api/integrations/{integrationId}/connect

For OAuth integrations, returns a redirect URL:

{
  "redirectUrl": "https://accounts.google.com/oauth/authorize?..."
}

For API key integrations:

{
  "apiKey": "your_api_key_here"
}

Disconnect Integration

Remove an integration connection.

Endpoint: DELETE /api/integrations/{integrationId}

Response: 204 No Content

Available Integrations