medusajs/medusa · error · Error

Group type is required if passing group id when tracking an…

Error message

Group type is required if passing group id when tracking an event with Posthog

What it means

When you pass a `group` with an `id` to the Posthog provider's `track` method, Posthog also needs a group `type` (the group key like 'company'). The provider rejects the combination id-without-type.

Solutions

1. Add a type: `group: { id: 'org_123', type: 'company' }`
2. Omit the group entirely if group analytics isn't needed

Example fix

// before
group: { id: organizationId }
// after
group: { id: organizationId, type: 'organization' }

if (dto.group?.id && !dto.group.type) {
  throw new Error('group.type is required when group.id is set')
}

const isValidGroup = (g?: { id?: string; type?: string }): boolean => !g?.id || Boolean(g.type)

When it happens

Trigger: Calling `track({ ..., group: { id: 'org_123' } })` with no `type` property.

Common situations: Partial group objects built from loosely-typed payloads, or assuming Posthog infers the group type from the id.

Understand the failure class

Background: "missing required argument" and "the following required arguments were not provided": what required-argument errors mean and how to fix them — this error's family across 20 libraries.

Related errors

• Actor ID is required when tracking an event with Posthog
• Actor or group is required when identifying an entity with…
• Event name is required when tracking an event with Posthog
• Posthog API key is not set, but is required
• A 'state' value is required to build the authorization URL

AI-assisted analysis of medusajs/medusa@5e06e544a2 (2026-08-27). Data as JSON: /api/errors/5cc2ac962c16bcee. Report an issue: GitHub.

Appendix: source

Thrown at packages/modules/providers/analytics-posthog/src/services/posthog-analytics.ts:51

      host: options.posthogHost || "https://eu.i.posthog.com",
    })
  }

  async track(data: ProviderTrackAnalyticsEventDTO): Promise<void> {
    if (!data.event) {
      throw new Error(
        "Event name is required when tracking an event with Posthog"
      )
    }

    if (!data.actor_id) {
      throw new Error(
        "Actor ID is required when tracking an event with Posthog"
      )
    }

    if (data.group?.id && !data.group?.type) {
      throw new Error(
        "Group type is required if passing group id when tracking an event with Posthog"
      )
    }

    this.client_.capture({
      event: data.event,
      distinctId: data.actor_id,
      properties: data.properties,
      groups: data.group?.id
        ? { [data.group.type!]: data.group.id }
        : undefined,
    })
  }

  async identify(data: ProviderIdentifyAnalyticsEventDTO): Promise<void> {
    if ("group" in data) {
      this.client_.groupIdentify({
        groupKey: data.group.id!,

View on GitHub (pinned to 5e06e544a2)