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

# How Do I Send External Rewards Using API Calls Through Campaigns?

> Enable external rewards through Gameball campaigns without additional development, to connect your existing loyalty system seamlessly.

| Platform          | Plan                  |
| ----------------- | --------------------- |
| Non-Platform only | Growth and Enterprise |

Gameball now supports engaging customers with gamified campaigns, even if you use your own loyalty program. You can leverage Gameball's campaign engine while sending external rewards -- like points, cashback, or physical gifts -- directly through their existing systems.

Gameball offers a new **External Reward (API Call)** option directly within campaign rewards.

<Frame>
  <img src="https://mintcdn.com/gameball/9WnFNxO9psy0HlAC/images/product-docs/rewards-campaigns/external-reward-option.png?fit=max&auto=format&n=9WnFNxO9psy0HlAC&q=85&s=73f912bece3cbca4301657437bc54b47" alt="External Reward API Call option" width="1914" height="876" data-path="images/product-docs/rewards-campaigns/external-reward-option.png" />
</Frame>

This feature allows you to:

<CardGroup cols={3}>
  <Card title="No Extra Development" icon="code">
    Connect your loyalty program without any additional backend development.
  </Card>

  <Card title="External Benefits" icon="gift">
    Reward customers with external benefits (points, cashback, physical goods, etc.) using a customizable API payload.
  </Card>

  <Card title="Fast Activation" icon="bolt">
    Speed up campaign activation and reduce technical dependencies.
  </Card>
</CardGroup>

***

## How to Configure External Rewards in Campaigns

<Steps>
  <Step title="Navigate to your Gameball dashboard" />

  <Step title="Go to Campaigns, then Rewards" />

  <Step title="Create or edit an existing Rewards campaign" />

  <Step title="Select External Reward (API Call)">
    Under **Rewards Types**, select **External Reward (API Call)**.

    <Frame>
      <img src="https://mintcdn.com/gameball/9WnFNxO9psy0HlAC/images/product-docs/rewards-campaigns/external-reward-select-type.png?fit=max&auto=format&n=9WnFNxO9psy0HlAC&q=85&s=3761e5c8e0bc1598dd5ad652a327f3c4" alt="Select External Reward type" width="1014" height="212" data-path="images/product-docs/rewards-campaigns/external-reward-select-type.png" />
    </Frame>
  </Step>

  <Step title="Fill in the required fields">
    * **Reward Name**
    * **API Data**
      * API URL
      * HTTP Method

    <Frame>
      <img src="https://mintcdn.com/gameball/9WnFNxO9psy0HlAC/images/product-docs/rewards-campaigns/external-reward-api-data.png?fit=max&auto=format&n=9WnFNxO9psy0HlAC&q=85&s=d98bead1161cd28d050c484adc76b604" alt="API data configuration" width="1380" height="734" data-path="images/product-docs/rewards-campaigns/external-reward-api-data.png" />
    </Frame>
  </Step>

  <Step title="Add dynamic variables">
    Include any of the following dynamic variables in the **Body** of the API data as needed, as well as the **Headers**:

    * `UniqueID`
    * `First Name`
    * `Last Name`
    * `Mobile Number`
    * `Email`
    * `CampaignID`
    * `Campaign Internal Name`
    * `Reward Name`

    <Frame>
      <img src="https://mintcdn.com/gameball/9WnFNxO9psy0HlAC/images/product-docs/rewards-campaigns/external-reward-dynamic-variables.png?fit=max&auto=format&n=9WnFNxO9psy0HlAC&q=85&s=12a29eede7f113571d25a1ccf3715d16" alt="Dynamic variables in API body" width="1380" height="660" data-path="images/product-docs/rewards-campaigns/external-reward-dynamic-variables.png" />
    </Frame>
  </Step>
</Steps>

<Note>This feature is available for campaign rewards only. It is not supported as a redemption method.</Note>

***

## Test API

Test API call configurations directly while setting up **Reward Campaigns** or **Automation Triggers**, ensuring your integrations work correctly before activation.

<Frame>
  <img src="https://mintcdn.com/gameball/9WnFNxO9psy0HlAC/images/product-docs/rewards-campaigns/external-reward-test-api.png?fit=max&auto=format&n=9WnFNxO9psy0HlAC&q=85&s=a70af21bfe86626161f107a6a0bea9b0" alt="Test API feature" width="1736" height="322" data-path="images/product-docs/rewards-campaigns/external-reward-test-api.png" />
</Frame>

When configuring an API call in a reward campaign, click **"Test API"** to send a sample request and view:

`Response: 200 OK - Connection successful`

This makes it easier than ever to validate your setup confidently before going live.

***

## Common Questions

<AccordionGroup>
  <Accordion title="Can I use this reward type with any loyalty system?" icon="circle-question">
    Yes, as long as your system accepts external API requests with the necessary data format.
  </Accordion>

  <Accordion title="Does this replace the webhook listener?" icon="circle-question">
    Yes. This eliminates the need to develop and maintain a webhook listener for reward distribution.
  </Accordion>
</AccordionGroup>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Introduction to Reward Campaigns" icon="flag" href="/product-documentation/rewards-campaigns/reward-campaign-intro">
    An overview of all reward campaign types and ready-made templates available in Gameball.
  </Card>

  <Card title="Introduction to Rewards Types" icon="gift" href="/product-documentation/rewards-campaigns/faqs/understanding-rewards-types">
    A detailed breakdown of every reward type and how to configure each one.
  </Card>
</CardGroup>