---
title: "Factory"
canonical_url: "https://docs.getdx.com/connectors/factory/"
md_url: "https://docs.getdx.com/connectors/factory.md"
last_updated: "2026-11-20"
---

# 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](https://app.factory.ai/settings/api-keys) as a Manager or Owner.
1. Create a personal API key and store it securely.

### Step 2: Add the connection in DX

1. In DX, go to **Admin** -> **Connections**.
1. Click **+ Connection**.
1. Select **Factory** under **Type**.
1. Enter your personal key in **API Key**.
1. 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](https://docs.factory.com/api-reference/analytics) |
| GET /api/v1/analytics/tokens | [Link](https://docs.factory.com/api-reference/analytics) |


## 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](https://docs.factory.com/api-reference/analytics) for details about the source metrics.
---

## Sitemap

[Overview of all docs pages](/llms.txt)
