View all connectors
Factory
Connect Factory to DX to analyze daily adoption, activity, productivity, and credit usage alongside your other engineering data.
Note: This connector requires Factory Enterprise. The Factory Teams plan does not provide the Analytics API access this connector needs.
Before you begin
- Factory access with the Manager or Owner role in your Enterprise organization.
- A personal API key belonging to that Manager or Owner. Service-account keys are not supported.
Setting up Factory
Step 1: Create a Factory API key
- Open Factory API key settings as a Manager or Owner.
- Create a personal API key and store it securely.
Step 2: Add the connection in DX
- In DX, go to Admin → Connections.
- Click + Connection.
- Select Factory under Type.
- Enter your personal key in API Key.
- Click Add connection.
API reference
The table below lists the specific API endpoints that are used by DX.
| Endpoint | Documentation |
|---|---|
| GET /api/v1/analytics/users | Link |
| GET /api/v1/analytics/tokens | Link |
Troubleshooting setup
Use these checks to resolve connection verification failures or missing model credits.
| Error or symptom | Action |
|---|---|
Factory API 403 enterprise_required |
Confirm that the organization has Factory Enterprise; Teams is not sufficient. |
Factory API 403 insufficient_role |
Use a personal API key belonging to a Manager or Owner. |
Invalid API key (Factory API 401) |
Check that you copied the complete, valid key, or create a replacement personal key. |
| No recent usage | Confirm that Factory analytics contains user activity within the last seven completed UTC days, then retry setup. Today’s activity alone does not satisfy this check. |
| Model credits are missing | Factory can omit billing fields from API responses; confirm billing visibility with your Factory admin. |
Next steps
Read the Factory Analytics API reference for details about the source metrics.