← Back to documentation

Troubleshooting

Fast triage workflow for method mismatches, auth failures, validation errors, and delivery issues.

10 min read

Use this workflow when requests are rejected or deliveries fail.

Purpose

This guide helps you:

  • Map Activity outcomes to likely root causes.
  • Separate sender issues from endpoint config issues and destination issues.
  • Validate recovery after fixes.

Prerequisites and permissions

  • Access to Request activity.
  • Access to endpoint and relay-target editing pages.

Step-by-step workflow

1. Start in Activity

  1. Open Request activity.
  2. Filter to affected endpoint.
  3. Open Request Log and inspect Errors.
  4. Capture timestamp range, outcome, and error reason.

2. Map outcome to source of failure

  • METHOD_NOT_ALLOWED: endpoint method mismatch.
  • MISSING_REQUIRED_HEADERS: missing/incorrect required headers.
  • AUTH_FAILED: inbound auth mismatch.
  • CAPTCHA_FAILED: missing/invalid captcha token or bad provider secret.
  • FIELD_VALIDATION_FAILED: payload fields fail configured validation.
  • DISABLED: endpoint is disabled.
  • DELIVERY_FAILED: request accepted, destination delivery failed.
  • TEST_REJECTED/TEST_RATE_LIMITED: relay-target test path issues.

3. Validate endpoint config

Check endpoint tabs:

  • Details: method, payload format, retries.
  • Security: inbound auth, captcha, required headers, CORS.
  • Field validation: rules and patterns.
  • Target destinations: outputs and per-output options.

4. Validate relay-target config

For delivery failures:

  1. Open each attached target.
  2. Verify URL, auth mode, headers, SSL enforcement.
  3. Run Send test.

If tests fail too, destination-side configuration/availability is usually the issue.

5. Confirm recovery

  1. Re-test with known-good payload.
  2. Verify outcomes move back to ACCEPTED/TEST_ACCEPTED.
  3. Continue monitoring for recurrence.

Expected result and verification checks

  • Root cause is identified and categorized.
  • Fix is confirmed by outcome trend improvement.

Common issues and fixes

  • Header mismatches: copy exact expected names/values.
  • Captcha still failing: align token field name and provider secret.
  • Intermittent delivery failures: check destination incident windows/rate limits.
  • No traffic after URL rotation: update sender to the new endpoint URL.

Related guides

← Back to documentation