Troubleshooting
Common issues teams run into when onboarding or operating WatchTower, and what to check first.
Section
Transactions are not appearing
- the request is hitting POST /api/v1/transactions
- the x-api-key header is present
- the idempotency-key header is present
- the payload is valid JSON
- the organization API key is active
Section
Alerts are not being created
- the transaction is ingesting successfully
- the payload includes enough context for the relevant controls
- thresholds are configured appropriately
- the test traffic is suspicious enough to trigger monitoring logic
Section
Login or invite flows are failing
Login checks
- the account exists in the correct environment
- the password is correct
- MFA is completed if enabled
- the invite was accepted if the user was onboarded through an invitation
Invite checks
- the invite is still active and not expired
- the environment base URL is configured correctly
- the user is opening the latest regenerated invite link
Password reset checks
- the reset token is valid and not expired
- the user is completing the flow in the correct environment
Section
Traffic appears low after onboarding
- whether the institution is genuinely low volume
- whether source systems stopped forwarding events
- tenant traffic trend and last successful ingestion time in the internal admin console
Section
When to escalate
- repeated 5xx responses
- sustained ingestion failure
- no traffic after a confirmed client release
- alert or case workflows failing after successful ingestion
Escalation threshold
If ingestion is confirmed live but operational workflows stop behaving as expected, escalate internally rather than continuing to replay the same failing requests.
Next UpError Handling
Continue Through The DocsWatchTower Integration Guides