Send Haptic Feedback

Trigger haptic feedback using the unified MiniKit API.

Use MiniKit.sendHapticFeedback() to trigger native haptic feedback.

Haptic Types

• "notification" — style: "success", "warning", or "error"
• "impact" — style: "light", "medium", or "heavy"
• "selection-changed" — no style needed

Basic Usage

Impact

import { MiniKit } from "@worldcoin/minikit-js";
import type { MiniKitSendHapticFeedbackOptions } from "@worldcoin/minikit-js/commands";

export async function sendImpactHaptic() {
  await MiniKit.sendHapticFeedback({
    hapticsType: "impact",
    style: "medium",
  } satisfies MiniKitSendHapticFeedbackOptions);
}

Result

Type

type SendHapticFeedbackResponse =
  | {
      executedWith: "minikit";
      data: {
        status: "success";
        version: number;
        timestamp: string;
      };
    }
  | {
      executedWith: "fallback";
      data: unknown;
    };

Fallback Behavior

Define a custom fallback in the command payload for support outside mini apps.

Error Codes

Code	Meaning
generic_error	Unexpected failure
user_rejected	The request was rejected