Hooks for developers
Updated November 9, 2026
Every board event also runs a WordPress action, so your own code can react: update another system, log changes, or add your own rules.
Event actions
| Action | Arguments |
|---|---|
kodadash/{event} | $ctx, for one event, such as kodadash/kanban_card_moved |
kodadash/event | $event, $ctx, for every event |
These run before notifications and webhooks are sent.
Event names
entry_updated, entry_deleted, entry_restored, calendar_entry_created, kanban_card_added, kanban_card_moved, kanban_card_assigned, kanban_card_completed, kanban_card_reopened, kanban_card_due_date_set, kanban_card_due_soon, kanban_card_overdue, kanban_card_note_added, kanban_card_mentioned, date_reminder, action_button_clicked.
What each one means: Emails for board events.
The $ctx array
| Key | Holds |
|---|---|
event / event_label | The event name, such as kanban_card_moved, and its label |
form / entry | The Gravity Forms form and entry arrays |
board_id / block_id / block | Where it happened. block is the block’s settings, or null |
user_id | Who did it (0 for KodaDash itself, such as a reminder) |
page_url | The page the board was on, when known |
data | The event’s details, such as column and previous_column ([id, label]), assignees, due_date, note, mentioned, or changes (each [id, label, old, new]) |
Example
add_action( 'kodadash/kanban_card_moved', function ( $ctx ) {
$to = $ctx['data']['column'][1] ?? '';
$from = $ctx['data']['previous_column'][1] ?? '';
error_log( sprintf( 'Entry %d moved from %s to %s', $ctx['entry']['id'], $from, $to ) );
} );
Other hooks
| Hook | Type | When |
|---|---|---|
kdash_board_saved | Action | A board is saved in the board editor. Passes $board_id. |
kdash_kanban_state_saved | Action | A Kanban card’s saved state changes, such as its column or priority. Passes $board_id, $block_id, $form_id, $entry_id, the previous row (or null for a new card) and the new values. |
kdash_media_pdf_previews | Filter | Whether the Media Gallery makes preview images of PDFs. Defaults to whether the server’s image editor can read PDFs. Return false to turn previews off. |
Checking a webhook signature
With a webhook secret set, compare the X-KodaDash-Signature header with your own HMAC of the raw body:
$body = file_get_contents( 'php://input' );
$expected = 'sha256=' . hash_hmac( 'sha256', $body, 'YOUR_SECRET' );
$received = $_SERVER['HTTP_X_KODADASH_SIGNATURE'] ?? '';
if ( ! hash_equals( $expected, $received ) ) {
http_response_code( 401 );
exit;
}
See Webhooks for what each send contains.
Thanks for letting us know.
