> For the complete documentation index, see [llms.txt](https://docs.klai.studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.klai.studio/reference/actions-processor/actions_overview/runoncompletehook.md).

# runOnCompleteHook

`runOnCompleteHook` triggers the form-completion hook flow and does not continue the action queue until that hook finishes.

## Action Object

| Key       | Type     | Description                                       |
| --------- | -------- | ------------------------------------------------- |
| `action`  | `string` | Must be `"runOnCompleteHook"`                     |
| `options` | `object` | Optional payload passed through the action object |

## Example

```json
{
  "action": "runOnCompleteHook"
}
```

## Behavior Notes

* BetterForms emits `runOnCompleteHook` on the client event bus.
* The action waits for the callback before moving to the next queued action.
* If the hook errors, BetterForms still continues the queue after the error is handled.
* Use this when a client-side workflow needs to wait for completion logic before continuing.

## Related Pages

* [Scoped Hooks](/reference/hooksoverview/hooks.md)
* [runUtilityHook](/reference/actions-processor/actions_overview/runutilityhook.md)