# Orb AI connector guide

Connect Orb data to AI agents with Combined. Explore subscriptions, customers, subscription usage, source setup, MCP access and read-only business queries.

Combined offers 1,125 connectors across catalog sources and connectors generated through desktop automation.

## Connect

1. Open Combined Connected Apps and select Orb.
2. Authorize the source and choose the relevant datasets.
3. Complete a first sync, then grant your agent access through the Set up or Access workspace.
4. Discover the actual source schemas before querying.

## Setup reference

- Orb API Key: required in the upstream source schema
- End Date: optional
- Lookback Window (in days): optional
- Event properties keys (numeric values): optional
- Orb Plan ID for Subscription Usage (string value): optional
- Start Date: required in the upstream source schema
- Event properties keys (string values): optional
- Subscription usage grouping key (string value): optional

## Dataset reference

- subscriptions; key: id; update field: created_at
- customers; key: id; update field: created_at
- subscription_usage; key: subscription_id, billable_metric_id, timeframe_start, grouping_key; update field: timeframe_start
- plans; key: id; update field: created_at
- invoices; key: id; update field: invoice_date
- credits_ledger_entries; key: id; update field: created_at

This is the upstream connector reference, version 2.1.22. Account permissions and sync configuration determine the datasets available in your workspace.

## Agent prompt

Use Combined to analyze my Orb data.
List my granted sources, discover the datasets and describe their fields.
Look for datasets corresponding to subscriptions, customers, subscription_usage, plans, invoices, credits_ledger_entries.
Check the last successful sync and report the available date coverage.
Propose three useful questions based on the fields actually available.
For the question I choose, run read-only SQL over the complete matching dataset.
Use a bounded result; include source names, time window and query receipt.
Ask for a missing join key or metric definition instead of inventing one.

## Links

- Combined: https://www.trycombined.com/
- Setup: https://www.trycombined.com/docs/getting-started/onboarding
- MCP: https://www.trycombined.com/docs/integrations/mcp
- Pricing: https://www.trycombined.com/pricing
- Upstream source reference: https://docs.airbyte.com/integrations/sources/orb
- Full guide: https://www.trycombined.com/connectors/orb