Simply Schedule Appointments icon
Events & Booking

Simply Schedule Appointments hooks reference

  • By NSquared
  • v1.6.13.6 New
  • Updated

Simply Schedule Appointments 1.6.13.6 has 23 actions and 56 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.

How to use these hooks

Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.

functions.phpyour child theme
// Run your own code when Simply Schedule Appointments fires an action
add_action( 'ssa/rate_limit/booking_throttled', function( $arg1, $arg2, $limit ) {
	// Your code runs here.
}, 10, 3 );

// Change a value Simply Schedule Appointments is about to use
add_filter( 'ssa/rate_limit/bypass', function( $value, $request ) {
	// Change $value here.
	return $value;
}, 10, 2 );

Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.

Changes by version

1.6.13.4 → 1.6.13.6 · Nov 17, 2026 · 0 added, 0 removed

No hooks were added or removed in this release.

All hooks

  • includes/class-rate-limit.php line 94 · used in 2 places
    /**
     * Short-circuit the rate limit for this request. Return true to skip counting
     * entirely (e.g. site-owner-maintained IP allowlist, internal monitoring
     * pings).
     */
    apply_filters( 'ssa/rate_limit/bypass', false, $request );
  • includes/lib/td-health-check/includes/class-health-check-debug-data.php line 735
    /**
     * Add or modify new debug sections.
     */
    apply_filters( 'debug_information', array() );
  • includes/lib/td-health-check/includes/class-health-check-troubleshoot.php line 81
    /**
     * Filter who may see the backup warning from the plugin.
     */
    apply_filters( 'health_check_backup_warning_required_capability', 'manage_options' );
  • includes/lib/td-health-check/pages/tools.php line 37
    /**
     * Filter the features available under the Tools tab.
     */
    apply_filters( 'health_check_tools_tab', array() );
  • includes/class-appointment-object.php line 616
    /**
     * Filters the list of attendees for an appointment.
     */
    apply_filters( 'ssa/appointment/attendees', $attendees, $this->id );
  • includes/class-rate-limit.php line 379
    /**
     * Override the native no-payment booking throttle. Same shape as the default:
     * integer 'limit' and integer 'window' (seconds). A limit below 1 disables the
     * throttle entirely.
     */
    apply_filters( 'ssa/rate_limit/booking_limit', $default );
  • includes/class-rate-limit.php line 346
    /**
     * Fired once when a native no-payment booking trips the silent throttle and is
     * about to be quarantined as 'abandoned'. The client still receives a 200
     * mirroring a real booking, so this is the only server-side signal that a
     * silent block happened — subscribers can use it to spot false positives
     * (e.g. a shared office/NAT IP) and tune ssa/rate_limit/booking_limit. The IP
     * is salted-hashed (same meth...
     */
    do_action( 'ssa/rate_limit/booking_throttled', self::hash_ip( $client_ip ), array( 'ip' => $ip_exceeded, 'email' => $email_exceeded, ), $limit );
  • includes/class-rate-limit.php line 219
    /**
     * Override the resolved client IP. Sites behind a non-Cloudflare reverse proxy
     * should return their own trusted resolution (typically the left-most hop in
     * X-Forwarded-For after validating REMOTE_ADDR is the known proxy). Returning
     * an empty string disables counting for this request.
     */
    apply_filters( 'ssa/rate_limit/client_ip', $ip );
  • includes/class-rate-limit.php line 567
    /**
     * Fired once per blocked request. Subscribers can log to whatever monitoring
     * they already use; no default logger is wired up here because under attack a
     * default error_log would fill the disk on shared hosts.
     */
    do_action( 'ssa/rate_limit/exceeded', $route_info['key'], self::hash_ip( $client_ip ), array( 'limit' => $route_info['limit'], 'window' => $route_info['window'], 'tier' => $route_info['tier'], ) );
  • includes/class-rate-limit.php line 173
    /**
     * Override the per-tier rate limit table. Useful for sites behind large shared
     * egress (university, corporate NAT) where the default read budget bites
     * legitimate concurrent users.
     */
    apply_filters( 'ssa/rate_limit/limits', $defaults );
  • includes/class-availability-functions.php line 319 · used in 3 places
    apply_filters( 'ssa/buffer_period/end_date', $booked_period, $booked_period, $appointment_type );
  • includes/class-availability-functions.php line 318 · used in 3 places
    apply_filters( 'ssa/buffer_period/start_date', $booked_period, $booked_period, $appointment_type );
  • includes/lib/td-util/class-td-db-model.php line 1174 · used in 2 places
    apply_filters( "query_{$this->slug}_db_where_conditions", $where, $args );
  • includes/class-upgrade.php line 126 · used in 2 places
    do_action( 'ssa_downgrade_paid_to_free' );
  • includes/class-upgrade.php line 131 · used in 2 places
    do_action( 'ssa_upgrade_free_to_paid' );
  • includes/class-appointment-model.php line 2226 · used in 2 places
    apply_filters( 'ssa/appointment/get_item_permissions_check', false, $params, $request );
  • includes/class-availability-functions.php line 272 · used in 2 places
    apply_filters( 'ssa/get_booked_periods/should_separate_availability_for_appointment_types', false );
  • includes/class-shortcodes.php line 1335 · used in 2 places
    apply_filters( 'ssa/mepr/shortcode/must_login_msg', __( 'You must be logged in to schedule an appointment. Please log in or register.', 'simply-schedule-appointments' ) );
  • includes/class-notifications.php line 1225 · used in 2 places
    do_action( 'ssa/notification/sent', $appointment_id, $response, $action_noun, $action_verb, $recipient_type, $notification_type, $data_after, $data_before, isset( $notification['title'] ) ? (string) $notification['title'] : '' );
  • includes/lib/td-health-check/includes/class-health-check-auto-updates.php line 486
    apply_filters( 'allow_dev_auto_core_updates', $wp_version );
  • includes/lib/td-health-check/includes/class-health-check-auto-updates.php line 520
    apply_filters( 'allow_minor_auto_core_updates', true );
  • includes/lib/td-health-check/includes/class-health-check-auto-updates.php line 184
    apply_filters( 'automatic_updater_disabled', false );
  • includes/lib/td-health-check/includes/class-health-check-auto-updates.php line 290
    apply_filters( 'automatic_updates_is_vcs_checkout', true, $context );
  • includes/lib/td-util/class-td-db-model.php line 1292
    apply_filters( "count_query_{$this->slug}_db_where_conditions", $where, $args );
  • admin-app/iframe-inner.php line 64
    do_action( 'ssa_admin_head' );
  • includes/class-templates.php line 600
    do_action( 'ssa_after_template_part', $template_name, $template_path, $located, $args );
  • booking-app-new/page-appointment-edit.php line 7
    apply_filters( 'ssa_appointment_edit_page_title', __( 'Edit Appointment', 'simply-schedule-appointments' ) );
  • includes/class-templates.php line 596
    do_action( 'ssa_before_template_part', $template_name, $template_path, $located, $args );
  • booking-app-new/iframe-inner.php line 127
    apply_filters( 'ssa_booking_appointment_types', $ssa_appointment_types );
  • booking-app-new/iframe-inner.php line 437
    do_action( 'ssa_booking_head' );
  • includes/class-shortcodes.php line 643
    apply_filters( 'ssa_booking_shortcode_atts', $atts );
  • ssa_loaded

    action
    simply-schedule-appointments.php line 603
    do_action( 'ssa_loaded' );
  • includes/class-settings.php line 71
    apply_filters( 'ssa_settings_computed_schema', array() );
  • includes/class-settings.php line 60
    apply_filters( 'ssa_settings_schema', array() );
  • simply-schedule-appointments.php line 840
    apply_filters( 'ssa_template_subdirectory', 'ssa/' );
  • ssa/api/token

    filter
    includes/class-db-model.php line 347
    apply_filters( 'ssa/api/token', SSA_Utils::site_unique_hash( 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9' ) );
  • includes/class-appointment-type-model.php line 1394
    apply_filters( 'ssa/appointment_type/availability/display_message', '' );
  • includes/class-hooks.php line 296
    do_action( 'ssa/appointment/abandoned', $appointment_id, $data_after, $data_before, $response );
  • includes/class-hooks.php line 189
    do_action( 'ssa/appointment/booked', $appointment_id, $data, $data_before, $response );
  • includes/class-hooks.php line 275
    do_action( 'ssa/appointment/canceled', $appointment_id, $data_after, $data_before, $response );
  • includes/class-hooks.php line 205
    do_action( 'ssa/appointment/customer_information_edited', $appointment_id, $data_after, $data_before, $response );
  • includes/class-hooks.php line 243
    do_action( 'ssa/appointment/edited', $appointment_id, $data_after, $data_before, $response );
  • includes/class-hooks.php line 101
    do_action( 'ssa/appointment/no_show', $data['appointment_id'], $data_after, $data );
  • includes/class-hooks.php line 146
    do_action( 'ssa/appointment/no_show_reverted', $data['appointment_id'], $data_after, $data );
  • includes/class-hooks.php line 166
    do_action( 'ssa/appointment/pending', $appointment_id, $data, $data_before, $response );
  • includes/class-hooks.php line 259
    do_action( 'ssa/appointment/rescheduled', $appointment_id, $data_after, $data_before, $response );
  • includes/class-customer-information.php line 64
    apply_filters( 'ssa/appointments/customer_information/get_defaults', $defaults );
  • includes/lib/td-util/class-td-async-action-model.php line 191
    apply_filters( 'ssa/async/retry_incomplete_actions', false );
  • includes/class-availability-functions.php line 48
    apply_filters( 'ssa/availability/default_args', array( 'start_date' => '', 'duration' => '', 'end_date' => '', 'start_date_min' => '', 'start_date_max' => '', 'end_date_min' => '', 'end_date_max' => '', 'buffered' => false, 'excluded_appointment_ids' => array(), 'appointment_statuses' => SSA_Appointment_Model::get_unavailable_statuses(), ), $appointment_type );
  • includes/class-appointment-type-model.php line 1418
    apply_filters( 'ssa/booking_app/availability_edge_cache/max_age', 5 * MINUTE_IN_SECONDS );
  • includes/class-appointment-type-model.php line 1483
    apply_filters( 'ssa/booking_app/availability_edge_cache/max_bytes', 512 * KB_IN_BYTES );
  • includes/class-appointment-type-model.php line 1442
    apply_filters( 'ssa/booking_app/availability_edge_cache/print', ! $this->plugin->appointment_model->is_privileged_appointment_request() );
  • includes/class-appointment-model.php line 1331
    apply_filters( 'ssa/booking/require_proof_token', $require_token, $params );
  • includes/class-availability-functions.php line 480
    apply_filters( 'ssa/buffer_period/blocked_period', $blocked_period, $blocked_period, $appointment_type );
  • includes/class-appointment-model.php line 2415
    apply_filters( 'ssa/edit_appointment_page_id', $settings_global['edit_appointment_page_id'], $appointment_id );
  • includes/class-notifications.php line 1430
    apply_filters( 'ssa/email/args', $args );
  • includes/class-support-status-api.php line 1060
    apply_filters( 'ssa/external_event_reclaim/enabled', true );
  • includes/class-forms.php line 61
    apply_filters( 'ssa/forms/pending_form_duration', $seconds_to_hold_pending_form_status, $appointment_id, $data );
  • includes/class-availability-functions.php line 346
    apply_filters( 'ssa/get_blocked_periods/blocked_periods', $blocked_periods, $appointment_type, $args );
  • includes/class-availability-functions.php line 363
    apply_filters( 'ssa/get_bookable_appointments/appointment_type', $appointment_type );
  • includes/class-availability-functions.php line 327
    apply_filters( 'ssa/get_booked_periods/booked_periods', $booked_periods, $appointment_type );
  • includes/class-shortcodes.php line 1401
    apply_filters( 'ssa/mepr/shortcode/booking_title', __('Booking for %s Membership', 'simply-schedule-appointments' ) );
  • includes/class-shortcodes.php line 1394
    apply_filters( 'ssa/mepr/shortcode/no_bookable_err_msg', __( 'You do not have any memberships that allow booking.', 'simply-schedule-appointments' ) );
  • includes/class-utils.php line 626
    apply_filters( 'ssa/moment_format', $moment_format, SSA_Translation::sanitize_locale( wp_unslash( $_GET["ssa_locale"] ) ) );
  • includes/class-notices-data.php line 349
    apply_filters( 'ssa/notices/all_notices', self::$all_notices );
  • includes/class-notifications.php line 213
    do_action( 'ssa/notification/scheduled', $appointment_id, $action_noun, $action_verb, $notification_date, $notification_time, $duration, $recipient_type, $data_after, $data_before, $notification_title );
  • includes/class-notifications.php line 1249
    apply_filters( 'ssa/notifications/email/args', array( 'sent_to' => $recipients['sent_to'], 'subject' => $subject, 'message' => $message, 'headers' => $headers, 'attachments' => $attachments, 'from_email' => $from_email, 'from_name' => $from_name, ), $notification, $notification_vars, $appointment_object, $recipient_type, $recipient_variables );
  • includes/class-notifications.php line 1204
    apply_filters( 'ssa/notifications/sms/args', array( 'to_number' => $to_number, 'notification' => $notification, 'notification_vars' => $notification_vars, 'appointment_object' => $appointment_object, 'subject' => $subject, 'message' => $sms_message, ) );
  • includes/class-shortcodes.php line 865
    apply_filters( 'ssa/performance/lazy_load', false );
  • includes/class-settings.php line 347
    do_action( "ssa/settings/{$section_key}/updated", $settings[$section_key], $old_settings[$section_key] );
  • includes/class-availability-cache-invalidation.php line 123
    apply_filters( 'ssa/shutdown/delete_all_transients', false );
  • includes/class-availability-cache-invalidation.php line 120
    apply_filters( 'ssa/shutdown/populate_cache', false );
  • includes/class-templates.php line 594
    apply_filters( 'ssa/templates/get_template', $located, $template_name, $args, $template_path, $default_path );
  • includes/class-templates.php line 554
    apply_filters( 'ssa/templates/get_template_part', $template, $slug, $name );
  • includes/class-templates.php line 82
    apply_filters( 'ssa/templates/get_template_vars', $vars, $template );
  • includes/class-templates.php line 678
    apply_filters( 'ssa/templates/locate_template', $template, $template_name, $template_path );

Generated from Simply Schedule Appointments's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.

Can't find the right hook?

We can build the customisation for you. Describe what you need: