Batch Events

posthog.batch
ActionBusiness appsconnection required

Calls the PostHog API with the connection's credentials.

Send a batch of events in one call.

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
PostHog
Secret shape
the project API key (phc_…), or {"api_key": "…"}
Config it needs
base_url
Resolved by
config.connection_id, else node.connection_id

Configuration

1 field, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
events
[{"event", "distinct_id", "properties"}] (JSON).
arrayYes—≥ 1 characters; array of object—

Output

One shape.

result

FieldTypeExample
sent
number—
{
  "sent": 0
}

Related PostHog nodes

See Batch Events run in a workflow.

In a technical demo we add the PostHog connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.