> ## 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.

# What Is Webhooks in Automation?

> Use actions that your players do on external apps to build you custom automation.

| Platform             | Plan                          |
| -------------------- | ----------------------------- |
| Shopify              | Guru                          |
| Salla                | Guru                          |
| Non-platform Clients | Included in Automation Add-on |

***

Webhooks in Gameball let you send and receive customer information to and from external applications, all within your automation flows. You can use webhooks as both **triggers** (to start an automation from an external event) and **actions** (to push customer data to another platform). [Learn more about Automated Workflows](/product-documentation/automation-campaigns/how-to-create-an-automation-campaign).

***

## Using Webhooks as a Trigger

You can create an automation triggered by an action the player initiates on an external app. For example, you want to reward your customers with 100 points for each review they leave on your review app.

<Steps>
  <Step title="Add the Webhook Trigger">
    From the Triggers panel, drag **Webhook Trigger** and drop it onto the canvas.
  </Step>

  <Step title="Configure the Webhook">
    Set up the webhook configuration:

    * Copy the **Webhook URL** that Gameball provides and paste it into the integration section of your external app, along with your API key for authentication.
    * Select how you want to **identify your players** (Email, External Customer ID, or Mobile Number).
    * Fill in the **payload** based on the selected identifier to confirm the format (e.g., `{payload.data.email}`).
    * Press **Save**.
  </Step>

  <Step title="Add the Points Action">
    Connect your trigger to the **Add Points** action:

    * Click **Add Points**.
    * Fill in the reward information.
    * Press **Save**.
  </Step>

  <Step title="Save the Automation">
    Press **Save** to finalize your automation.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/webhook-trigger-setup.gif?s=e8252bed1eda07c08d8cd87c5c8b4a05" alt="Setting up a webhook trigger in automation" width="2880" height="1434" data-path="images/product-docs/automation-campaigns/webhook-trigger-setup.gif" />
</Frame>

***

## Using Webhooks as an Action

You can use webhooks as an action within your automation to send customer information to an external app. For example, you want to send a welcome email using your external mailing app to a new customer who just created an account.

<Steps>
  <Step title="Add the Trigger">
    Drag the **Account Created** trigger onto the canvas.
  </Step>

  <Step title="Connect to Send Webhook">
    Connect it to the **Send Webhook** action.
  </Step>

  <Step title="Configure the Webhook">
    Set up the webhook configuration:

    * Paste your external app's webhook URL in the **Webhook URL** field.
    * Choose your **HTTP method** (POST, GET, or PUT).
    * Add the player information you want to send in the **Webhook body**. You can use JSON format, the visual builder, or select from customer variables.

    <Frame>
      <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/webhook-action-body.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=e9d4547a2f57e505f62603e6ae055908" alt="Webhook action body configuration" width="766" height="788" data-path="images/product-docs/automation-campaigns/webhook-action-body.png" />
    </Frame>

    * Add the required **Headers**.

    <Frame>
      <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/webhook-action-headers.png?fit=max&auto=format&n=Ym44GvndYOgHCcbm&q=85&s=7b434d2b285e107d1fa7cf267449cbee" alt="Webhook action headers configuration" width="766" height="240" data-path="images/product-docs/automation-campaigns/webhook-action-headers.png" />
    </Frame>

    * Press **Save**.
  </Step>

  <Step title="Save the Automation">
    Press **Save** to finalize your automation.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/gameball/Ym44GvndYOgHCcbm/images/product-docs/automation-campaigns/webhook-action-setup.gif?s=8ac50d0919b7d7db93e34c0f6ff68ff5" alt="Setting up a webhook action in automation" width="2880" height="1434" data-path="images/product-docs/automation-campaigns/webhook-action-setup.gif" />
</Frame>

<Note>
  **Payload Configuration:**

  * If the action is to send an email within Gameball, add a configuration field to specify the payload part for the customer's email (`{payload.data.email}`).
  * If the action is external, add all required details for the webhook link and payload in JSON format.

  ```json theme={null}
  {"email": "email"}
  ```
</Note>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Introduction to Automation Campaigns" icon="bolt" href="/product-documentation/automation-campaigns/introduction-to-automation-campaigns">
    Learn the fundamentals of Gameball's automation campaign system.
  </Card>

  <Card title="How to Create an Automation Campaign" icon="wand-magic-sparkles" href="/product-documentation/automation-campaigns/how-to-create-an-automation-campaign">
    Step-by-step guide to building and launching automation workflows.
  </Card>

  <Card title="Making Edits on Active Automation" icon="pen-to-square" href="/product-documentation/automation-campaigns/making-edits-on-active-automation">
    Understand how changes to a live automation affect your customers.
  </Card>
</CardGroup>
