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

# Reward Issued

This webhook is sent each time an individual reward is successfully issued
to a user during a partner issuance job. If a batch contains 100 identifiers,
up to 100 individual `reward.issued` webhooks may be sent (one per
successful issuance).

### Event

`reward.issued`

### Payload Description

<ParamField body="event" type="string">
  The event type: `reward.issued`
</ParamField>

<ParamField body="timestamp" type="string">
  The time the event occurred (ISO8601)
</ParamField>

<ParamField body="data" type="hash">
  Event data

  <Expandable title="data">
    <ParamField body="issuance_job_id" type="string">
      The ID of the issuance job that triggered this reward
    </ParamField>

    <ParamField body="merchant_id" type="string">
      The ID of the merchant associated with the issuance job
    </ParamField>

    <ParamField body="reward_id" type="string">
      The ID of the issued reward
    </ParamField>

    <ParamField body="identifier" type="hash">
      The identifier used to issue the reward

      <Expandable title="identifier">
        <ParamField body="type" type="string">
          Identifier type: `email` or `phone`
        </ParamField>

        <ParamField body="index" type="integer">
          Position in the original identifiers array
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="user_id" type="string">
      The ID of the user who received the reward, if found
    </ParamField>

    <ParamField body="state" type="string">
      The reward state (e.g., `active`, `pending`, `delivered`)
    </ParamField>

    <ParamField body="expires_at" type="string">
      The reward expiration date (ISO8601), if applicable
    </ParamField>

    <ParamField body="campaign" type="hash">
      Campaign information

      <Expandable title="campaign">
        <ParamField body="id" type="string">
          Campaign ID
        </ParamField>

        <ParamField body="name" type="string">
          Campaign name
        </ParamField>

        <ParamField body="objective" type="string">
          Campaign objective
        </ParamField>

        <ParamField body="start_at" type="string">
          Campaign start date (ISO8601)
        </ParamField>

        <ParamField body="end_at" type="string">
          Campaign end date (ISO8601)
        </ParamField>

        <ParamField body="redeemable_from" type="string">
          Reward redemption start date (ISO8601)
        </ParamField>

        <ParamField body="redeemable_to" type="string">
          Reward redemption end date (ISO8601)
        </ParamField>

        <ParamField body="time_zone" type="string">
          Campaign time zone
        </ParamField>

        <ParamField body="fine_print" type="string">
          Terms and conditions
        </ParamField>

        <ParamField body="variant" type="hash">
          The variant used for issuance

          <Expandable title="variant">
            <ParamField body="id" type="string">
              Variant ID
            </ParamField>

            <ParamField body="name" type="string">
              Variant name
            </ParamField>

            <ParamField body="reward_template_id" type="string">
              Reward template ID
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<ResponseExample>
  ```json theme={null}
  {
    "event": "reward.issued",
    "timestamp": "2025-06-15T10:30:10Z",
    "data": {
      "issuance_job_id": "job_xyz789",
      "merchant_id": "mer_abc123",
      "reward_id": "rwd_abc123",
      "identifier": {
        "type": "email",
        "index": 0
      },
      "user_id": "usr_def456",
      "state": "active",
      "expires_at": "2025-09-30T23:59:59Z",
      "campaign": {
        "id": "camp_abc123",
        "name": "Summer Free Coffee",
        "objective": "Re-engage lapsed customers",
        "start_at": "2025-06-01T00:00:00Z",
        "end_at": "2025-08-31T23:59:59Z",
        "redeemable_from": "2025-06-01T00:00:00Z",
        "redeemable_to": "2025-09-30T23:59:59Z",
        "time_zone": "America/Los_Angeles",
        "fine_print": "Limit one per customer",
        "variant": {
          "id": "var_treat1",
          "name": "Treatment",
          "reward_template_id": "abc123def456"
        }
      }
    }
  }
  ```
</ResponseExample>