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

# Postback & Gruum

> Record a conversion or transaction postback against a prior click; Gruum conversion.

[← Back to API Integration](/integration/api-integration)

Requires an API key — see [Authentication](/integration/api-integration/authentication).

<Info>
  These two endpoints are real and supported, but weren't included in the client-facing HTML reference this page was built from — that source only documented 10 of the 12 live endpoints. They're kept here rather than dropped.
</Info>

## Save postback transaction

<span className="text-xs font-mono font-semibold bg-[#07C983]/15 text-[#15803D] dark:bg-[#07C983]/20 dark:text-[#07C983] px-2 py-1 rounded">GET</span> `/api/v1/postback/crumb`

Records a conversion/transaction postback against a prior click.

<ParamField query="order" type="string" required>
  The order ID.
</ParamField>

<ParamField query="click_id" type="string" required>
  The click reference tracking ID.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --get "$BASE/api/v1/postback/crumb" \
    -d "order=ORD-12345" \
    -d "click_id=rewards_123..." \
    --header "X-API-Key: $KEY"
  ```

  ```javascript JavaScript theme={null}
  const url = new URL(`${BASE}/api/v1/postback/crumb`);
  url.search = new URLSearchParams({ order: "ORD-12345", click_id: "rewards_123..." });

  const res = await fetch(url, {
    headers: { "X-API-Key": KEY },
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  { "status": "success", "message": "Order saved" }
  ```
</ResponseExample>

See [Errors](/integration/api-integration/errors) for error shapes.

## Gruum conversion

<span className="text-xs font-mono font-semibold bg-[#0B1B2B]/10 text-[#0B1B2B] dark:bg-[#0B1B2B]/40 dark:text-white px-2 py-1 rounded">POST</span> `/api/v1/gruum/conversion`

Records a Gruum conversion event.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "$BASE/api/v1/gruum/conversion" \
    --header "X-API-Key: $KEY" \
    --header "Content-Type: application/json"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": [{ "id": "67dd795d86f2741c8842cbf1" }]
  }
  ```
</ResponseExample>

See [Errors](/integration/api-integration/errors) for error shapes.