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

ActionArguments
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

KeyHolds
event / event_labelThe event name, such as kanban_card_moved, and its label
form / entryThe Gravity Forms form and entry arrays
board_id / block_id / blockWhere it happened. block is the block’s settings, or null
user_idWho did it (0 for KodaDash itself, such as a reminder)
page_urlThe page the board was on, when known
dataThe 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

HookTypeWhen
kdash_board_savedActionA board is saved in the board editor. Passes $board_id.
kdash_kanban_state_savedActionA 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_previewsFilterWhether 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.

Was this page helpful?
Scroll to top