# Truto Webhook Workflow Debugger

> Debug Truto webhooks, webhook logs, workflows, workflow runs, notification destinations, sync-job webhook delivery, and event-triggered automation with CLI. Use for delivery failures, missing events, verification issues, workflow failures, or notification problems.

- Skill: `yuvraj3335/truto-webhook-workflow-debugger` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add yuvraj3335/truto-webhook-workflow-debugger`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yuvraj3335/truto-webhook-workflow-debugger/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: yuvraj3335 (https://skillmd.com/u/yuvraj3335)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/yuvraj3335/truto-webhook-workflow-debugger

---


# Truto Webhook Workflow Debugger

## Mission

Build an event timeline from configuration, logs, and run records. Identify whether the issue is missing trigger, disabled config, payload/condition mismatch, delivery failure, provider/API failure, or runtime error.

## Inputs

Use profile, webhook ID, workflow ID, workflow run ID, notification destination ID, account ID, event name, target URL, sync job run ID, and time window.

## Webhooks

```bash
truto webhooks list -p "$PROFILE" -o json --no-color
truto webhooks get "$WEBHOOK_ID" -p "$PROFILE" -o json --no-color
truto logs --log-type webhook --webhook-id "$WEBHOOK_ID" --start "$START" --end "$END" --limit 100 -p "$PROFILE" -o json --no-color
```

For sync job delivery:

```bash
truto logs --log-type rapid_bridge --webhook-id "$WEBHOOK_ID" --start "$START" --end "$END" --limit 100 -p "$PROFILE" -o json --no-color
truto sync-job-runs get "$SYNC_JOB_RUN_ID" -p "$PROFILE" -o json --no-color
```

## Workflows

```bash
truto workflows list -p "$PROFILE" -o json --no-color
truto workflows get "$WORKFLOW_ID" -p "$PROFILE" -o json --no-color
truto workflow-runs list --workflow-id "$WORKFLOW_ID" --status "$STATUS" -p "$PROFILE" -o json --no-color
truto workflow-runs get "$WORKFLOW_RUN_ID" -p "$PROFILE" -o json --no-color
```

## Notifications

```bash
truto notification-destinations list -p "$PROFILE" -o json --no-color
truto notification-destinations get "$DESTINATION_ID" -p "$PROFILE" -o json --no-color
```

## Test Policy

These send external events. Run only after explicit approval:

```bash
truto webhooks test --id "$WEBHOOK_ID" -p "$PROFILE" -o json --no-color
truto notification-destinations test --id "$DESTINATION_ID" -p "$PROFILE" -o json --no-color
```

## Diagnosis

- Config is active and target URL/destination is correct.
- Expected event name exists and matches filters/conditions.
- Logs show whether an event was created, attempted, retried, delivered, or rejected.
- Delivery failure includes status code and response summary.
- Workflow run failed due to condition mismatch, step config, provider/API call, or runtime error.
- Sync job finished and produced destination payload before webhook delivery was expected.

## Output

Return event timeline, missing or failing stage, evidence, whether a safe test is allowed, and next fix.