New Customers: The number of customers acquired in the period: customers whose first paid subscription started in the period.
Formula
New Customers = Count of customers with a new revenue event in the period Computable definition
The canonical formula in the GASP formula grammar. The MCP server compiles it to SQL over the datasets listed below.
count_distinct(field.customer_id where field.event_type = 'new') Unit: count
Breakdowns
by_segment: one row persegmentvalue
Notes: Customers whose first paid subscription started in the period (a new revenue event). Reactivated customers return through a reactivation event and are not new. CAC divides by it. by_segment returns one row per customer segment.
Data requirements
Grain: Per event, aggregate monthly · Frequency: Daily sync · Aggregation: aggregate (month) · Staged: no · Main source: Billing.
| Field | Dataset | Type |
|---|---|---|
customer_id | revenue_event | string |
event_date | revenue_event | date |
event_type | revenue_event | string |
Example SQL (Postgres)
SELECT (SELECT COUNT(DISTINCT customer_id) FROM revenue_event WHERE event_date >= :period_start AND event_date <= :period_end AND event_type = 'new') AS new_customers Access: recommended
sensitivity tier confidential,
access scope unscoped.
Guidance your policy engine enforces.
From an agent: with the GASP MCP server, call
lookup_metric({ "name": "New Customers" }) or generate_query({ "metric": "New Customers", "adapter": "<your adapter JSON>" }).
What It Tells You
The output of the acquisition engine in logos rather than dollars. New Customers x ACV equals New MRR x 12, so when the two trends part, deal size has moved.
Related Metrics
Connected in the GASP relationship graph.
Upstream: what drives this
- Trial-to-Paid Conversion Rate drives New Customers (Product)
Downstream: what this drives
- New Customers drives New MRR (Core)
- New Customers component of CAC (Core)
- New Customers measures Customer (Entity)
- New Customers measures Subscription (Entity)