> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thrad.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Testing and troubleshooting

> Validate an integration safely before sending live conversions.

Set `test_mode: true` on the request envelope to validate the envelope and every event without creating a canonical record or forwarding to OpenAI. Use this as the final integration check before sending live conversions.

```json theme={null}
{
  "version": 1,
  "tag_id": "adv_example_123",
  "test_mode": true,
  "events": [{ "event_id": "test-order-123", "event_name": "order_created", "timestamp_ms": 1773892800000, "action_source": "web", "source_url": "https://shop.example.com/confirmation", "data": { "type": "contents" } }]
}
```

## Results

Inspect every result in a `200` response. Possible statuses are `accepted`, `duplicate`, `suppressed`, `invalid`, and, in test mode, `validated`. Retry the complete request with the same event IDs only after a `503`, when Thrad could not determine a durable outcome.

## Common errors

* `invalid_timestamp`: correct the system clock or send the event within the supported time window.
* `invalid_identity`: send valid lowercase SHA-256 hex values, or supported plaintext arrays for local hashing.
* `invalid_context`: do not alter click signatures, `oppref`, `oppcref`, or `obref`.
* `no_attribution_signal`: include a signed Thrad context, an OpenAI reference, or a supported matching identifier.
* `measurement_consent_denied`: do not retry until measurement consent is granted for a new event.
* `duplicate_event`: the original event was accepted; do not create a new ID for a retry.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.