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

  1. Open Factory API key settings as a Manager or Owner.
  2. Create a personal API key and store it securely.

Step 2: Add the connection in DX

  1. In DX, go to Admin → Connections.
  2. Click + Connection.
  3. Select Factory under Type.
  4. Enter your personal key in API Key.
  5. 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.