PostHog Identify

PostHog Identify

Certified

Identify a PostHog user

Sets or updates the person properties of the user identified by distinctId, by sending an $identify event with the properties in $set. Uses the project API key (phc_). Unlike the frontend identify, this does not merge an anonymous user into an identified one: use Alias for that.

yaml
type: io.kestra.plugin.posthog.Identify

Identify a user and set their properties

yaml
id: user_onboarding_tracking
namespace: company.growth

inputs:
  - id: user_id
    type: STRING
  - id: plan
    type: STRING

tasks:
  - id: identify_user
    type: io.kestra.plugin.posthog.Identify
    apiKey: "{{ secret('POSTHOG_API_KEY') }}"
    host: "https://us.i.posthog.com"
    distinctId: "{{ inputs.user_id }}"
    properties:
      plan: "{{ inputs.plan }}"
      onboarding_completed: true
Properties

PostHog project API key

The project API key (starts with phc_). Use a Kestra secret, e.g. {{ secret('POSTHOG_API_KEY') }}.

Distinct ID

The distinct ID of the user to identify.

Person properties

The properties to set on the person, sent as $set. At least one property is required. Properties with a null value are omitted: a null does not unset a property.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

PostHog host

The PostHog ingestion host, e.g. https://us.i.posthog.com (US Cloud), https://eu.i.posthog.com (EU Cloud) or a self-hosted URL. Defaults to US Cloud when empty.