funnel

Call funnel.set_conversion_event

Record the ONE event that counts as a conversion for this funnel — 'a booked call is our conversion', 'count a purchase as the win' — in the member's own words. This is the number the funnel is judged on, so ask them and use their answer verbatim rather than choosing one. It changes no page, no pixel and no connection: it writes the decision onto the funnel's plan. Say plainly that conversions are not yet counted against the funnel in the outcomes ledger, so recording this does not by itself make the closing event observable. Not for which Google Analytics conversions the brand reports — that is connections.set_conversion_events.

Every result names the workspace it ran in. Say which workspace the answer is about. When the account has more than one workspace and none is selected, this tool refuses with workspace_ambiguous and lists the choices — offer them, never pick one.

post/api/v1/tools/funnel.set_conversion_event

Request

  • Base URL: https://app.goosybear.ai
  • URL: https://app.goosybear.ai/api/v1/tools/funnel.set_conversion_event
  • Auth: HTTP bearer

Headers

x-request-idstring

Your own id for this request, echoed back and recorded on the audit trail. 1–128 characters from A–Z a–z 0–9 . _ : -, starting with a letter or digit; anything else is replaced by a generated id.

Request body

project_board_idstring uuid

The funnel's project id, if you have one from something you were shown. If you do not, use funnel_name instead — do not guess a uuid.

funnel_namestring

What the member calls the funnel, when you do not have its id. It is matched against their own projects only.

conversion_eventstring required

The ONE thing that counts as a conversion for this funnel, in the member's own words — a booked call, a purchase, an application submitted. Their answer verbatim; never a tidied-up version of it and never one you chose.

workspacestring

Which workspace to run in — its slug. Omit to use your default. With more than one reachable workspace and no default, the call is refused and the choices are listed.

Response

The call was admitted and dispatched. ok says whether the tool succeeded — a refusal the tool itself produced is still a 200, exactly as it is a successful JSON-RPC result over MCP.

OR

Changes

No recorded changes to this operation across all 8 revisions of this API.