## How the Stitch integration works

Enabling the Stitch integration for Statsig allows Statsig to push events to your Stitch account through a webhook. This allows you to forward Statsig data to any connectors available from Stitch.

## Configuring outbound events

1. Follow the steps in the [Stitch Webhook Setup Guide](https://www.stitchdata.com/docs/integrations/webhooks/stitch-incoming-webhooks#setup) to create a new Webhook URL.
2. On the Statsig [Integrations](https://console.statsig.com/integrations) page, enable the Stitch integration by pasting in the Stitch Webhook URL and click **Confirm**.

### Event format

Events are sent in batches in JSON format. Each Statsig event has the following structure:

| Field           | Type   | Description                                                                                      |
| --------------- | ------ | ------------------------------------------------------------------------------------------------ |
| event           | String | Name of the event provided                                                                       |
| user            | JSON   | [Statsig User Object](/sdks/user)                             |
| userId          | String | User ID provided                                                                                 |
| stableId        | String | Stable ID                                                                                        |
| timestamp       | Number | Timestamp in MS of the event                                                                     |
| value           | String | Value of the event provided                                                                      |
| metadata        | JSON   | Both custom metadata provided and metadata related to the logging of this event added by Statsig |

#### Custom event formatting - logEvent

>

```json
{
  "userId": "a_user",
  "stableId": "123",
  "timestamp": 1655231253265,
  "event": "my_custom_event",
  "context": {
    "user": {
      "userID": "a_user",
      "email": "a.user@email.com"
    },
    "value": "a_custom_value",
    "metadata": {

    },
    "library": {
      "name": "statsig",
      "version": "1.0"
    }
  }
}
```

#### Feature gate exposure formatting - checkGate

>

```json
{
  "userId": "a_user",
  "stableId": "123",
  "timestamp": 1655231253265,
  "event": "statsig::gate_exposure",
  "context": {
    "user": {
      "userID": "a_user",
      "email": "a.user@email.com"
    },
    "value": "",
    "metadata": {
      "gate": "a_gate",
      "gateValue": "false",
      "ruleID": "default",
      "reason": "Network",
      "time": "1655231249644"
    },
    "library": {
      "name": "statsig",
      "version": "1.0"
    }
  }
}
```

#### Dynamic config exposure formatting - getConfig

>

```json
{
  "userId": "a_user",
  "stableId": "123",
  "timestamp": 1655231253265,
  "event": "statsig::config_exposure",
  "context": {
    "user": {
      "userID": "a_user",
      "email": "a.user@email.com"
    },
    "value": "",
    "metadata": {
      "config": "a_config",
      "ruleID": "default",
      "reason": "Network",
      "time": "1655231249644"
    },
    "library": {
      "name": "statsig",
      "version": "1.0"
    }
  }
}
```

#### Experiment exposure formatting - getExperiment

>

```json
{
  "userId": "a_user",
  "stableId": "123",
  "timestamp": 1655231253265,
  "event": "statsig::experiment_exposure",
  "context": {
    "user": {
      "userID": "a_user",
      "email": "a.user@email.com"
    },
    "value": "",
    "metadata": {
      "config": "an_experiment",
      "ruleID": "4SauZJcM1T7zNvh1igBjwE",
      "reason": "Network",
      "time": "1655231249644",
      "experimentGroupName": "Control"
    },
    "library": {
      "name": "statsig",
      "version": "1.0"
    }
  }
}
```

## Filtering events

After you enable outbound events to Stitch, you can select which categories of Statsig events to export by clicking the **Event Filtering** button and checking the appropriate boxes as shown below.

{% figure %}
![Initial Setup Dialog](/images/integrations/data-connectors/stitch/183725742-b58c87a7-fbb4-4f30-be9a-9d20c08cd7d0.png)
{% /figure %}

{% figure %}
![Event Filtering](/images/integrations/data-connectors/stitch/183725752-b79b5c3f-d275-4dec-80ba-04fa9a73da0d.png)
{% /figure %}