# Event payload shape

When sending [analytics events](/integrations/getting-data-out/analytics.md), you have control over the shape of the payload received by the destination.

<figure><img src="/files/b7uTsWlDCN4ZisU3Twux" alt=""><figcaption><p>Payload shape configurations for the Google Tag Manager analytics integration.</p></figcaption></figure>

## Allowing answer sending

### Send answers

By default, answers are not included in analytics event payloads. This way, analytics providers can be used for tracking conversion and performance, without sending user data to third parties.

If **send answers** is checked, answer values will be nested in an "answers" object of the event payload.

### Send PII

If **send answers** is enabled, **send PII** will also send Personally Identifying Information along to the analytics provider. Answers are marked as PII using the [data classification](/response-data-collection-and-management/variable-schema.md#semantic-meaning) in the schema editor.

### Only send answers from current step

If **only send answers from current step** is enabled, the payload will only contain answers to questions that appear on the current step.

{% hint style="info" %}
When sending answers from the current step, by default you will not receive any answers that are present at the beginning of the flow, such as [external answers](/response-data-collection-and-management/variable-schema/external-answers.md).

To instead send the current, full state of the flow on load, enable **Send all answers on FlowLoaded**, which will include the entire answer state in the FlowLoaded event's answer payload.
{% endhint %}

## Payload shape

All analytics events will contain the flow label, variant label, variant revision UUID, and responder UUID.

```javascript
{
  "first_name": "John Doe",
  "flowLabel": "<FLOW_LABEL>",
  "variantLabel": "<VARIANT_LABEL>",
  "variantUuid": "<VARIANT_UUID>",
  "responderUuid": "<RESPONDER_UUID>"
}
```

### Answers at root

With **answers at root** checked, all the answer keys will be at the same level of nesting within the payload object.

```javascript
{
  "address.raw": "123 Test St, Beverly Hills, CA 90210",
  "address.address_1": "123 Test St",
  "address.city": "Beverly Hills",
  "address.state": "CA",
  "address.postal_code": "90210",
  "utm_source": "facebook_ad",
  "first_name": "John Doe",
  "flowLabel": "<FLOW_LABEL>",
  "variantLabel": "<VARIANT_LABEL>",
  "variantUuid": "<VARIANT_UUID>",
  "responderUuid": "<RESPONDER_UUID>"
}
```

If unchecked, the answers will be nested within an `answers` object.

```javascript
{
  "answers": {
    "address.raw": "123 Test St, Beverly Hills, CA 90210",
    "address.address_1": "123 Test St",
    "address.city": "Beverly Hills",
    "address.state": "CA",
    "address.postal_code": "90210",
    "utm_source": "facebook_ad",
    "first_name": "John Doe"
  },
  "flowLabel": "<FLOW_LABEL>",
  "variantLabel": "<VARIANT_LABEL>",
  "variantUuid": "<VARIANT_UUID>",
  "responderUuid": "<RESPONDER_UUID>"
}
```

### Flatten answer keys

With **flatten answer keys** checked, nested answers, like arrays and objects, will be at the same level of nesting as all other answers:

```javascript
{
  "answers": {
    "address.city": "Beverly Hills"
  }
}
```

With **flatten answer keys** unchecked, nested answers will remain in their original, nested shape.

```javascript
{
  "answers": {
    "address": {
      "city": "Beverly Hills"
    }
  }
}
```

### Stringify answers

When **stringify answers** is checked, the `answers` key itself will be a JSON string of the answers, rather than the nested object.

```javascript
{
  "flowLabel": "<FLOW_LABEL>",
  "variantLabel": "<VARIANT_LABEL>",
  "variantUuid": "<VARIANT_UUID>",
  "responderUuid": "<RESPONDER_UUID>",
  "answers": "{\"address.raw\":\"123 Test St, Beverly Hills, CA 90210\",\"address.address_1\":\"123 Test St\",\"address.city\":\"Beverly Hills\",\"address.state\":\"CA\",\"address.postal_code\":\"90210\",\"utm_source\":\"facebook_ad\",\"first_name\":\"John Doe\"}"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.formsort.com/integrations/getting-data-out/event-payload-shape.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
