ClickSomo

List Contacts

List contacts in this project.

Get Contact

One contact, with their consent ledger.

Upsert Contact

Create or update a contact by email. Does NOT grant consent — a contact with no lawful basis cannot be mailed, and consent is never inferred from being added.

List Segments

Saved segments in this project.

Preview Segment

How many contacts a predicate matches, without saving it.

List Funnels

Every funnel and its status.

Get Funnel

One funnel and its live graph — or its saved draft graph when it has never been published. `graphSource` says which.

Create Funnel

Create an empty funnel. Publish a graph into it separately.

Check Funnel

Validate a graph without publishing it. Returns every problem at once. The one worth knowing: a loop with no wait in it is refused, because it would run for ever at full speed.

Publish Funnel

Publish a graph as the funnel's next version. Contacts already walking keep walking the version they entered — editing a live funnel never moves anybody. If the funnel has a saved draft (an import, or somebody's work in the builder), the graph must equal that draft; a different graph is refused with a conflict and the draft is kept, so read the funnel's draft first rather than publishing over it.

Pause Funnel

Stop new runs. Contacts already in flight carry on — freezing them would mean somebody gets the first two emails of three and never the last.

Simulate Funnel

Dry-run a contact through a funnel and return the path taken and the messages it WOULD send. Sends nothing and writes nothing. Waits advance a virtual clock, so one call shows the whole sequence and when each message lands. Conditions are not evaluated — they are answered by the database — so each is reported in `assumptions` with the branch taken; pass `assume` to explore the other path.

Generate Funnel

Design a funnel from a sentence. The result is validated by the same checker that gates publishing and then simulated, so what comes back is a funnel that runs rather than one that looks plausible.

Create Email

Write an email from a brief. Validated against the block schema and rendered before it is returned — a block list that satisfies the schema and throws in the renderer is not a usable email.

List Campaigns

Every campaign and its status.

Report Campaign

A campaign's numbers, recomputed from events. Opens and clicks come in three flavours — raw, people (machines removed) and machines — because Apple Mail prefetches every pixel and corporate scanners pre-click every link.

Get Campaign

One campaign.

Start Funnel Run

Put a REAL contact into a live funnel. This sends real messages to a real person, so it requires confirm: true. Use simulate_funnel to see what would happen first.