# submission.customer_replied

HTML: https://www.app2email.com/docs/api/webhooks/submission.customer_replied · Index: https://www.app2email.com/docs/api/llms.txt

The submitter added something to a submission: text or files after Add more or on their status page, a follow-up form, or a button of a reply.

Group: Submit-Info. Header `X-App2email-Event: submission.customer_replied`. Inside the envelope `{id, type, created, number, test?, data}` ([envelope, headers, signature](https://www.app2email.com/docs/api/webhooks.md)). Every webhook of the number gets every number event: filter by `type`.

## data

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data.id` | integer | yes |  |
| `data.reference` | string | yes | The short code the submitter sees: the form's prefix and 6 characters. Every route that takes a submission id takes it too. |
| `data.form` | object | yes | The form it was made with. |
| `data.form.key` | string |  |  |
| `data.form.name` | string |  |  |
| `data.channel` | string |  | whatsapp: the WhatsApp form. web: the web page. api: POST /submit/submissions. staff: entered by a team member.; one of: `whatsapp`, `web`, `api`, `staff` |
| `data.status` | string | yes | The key of the stage it is in (the form's stages). |
| `data.status_name` | string |  |  |
| `data.status_kind` | string |  | one of: `open`, `done`, `cancelled` |
| `data.status_color` | string |  | one of: `grey`, `blue`, `green`, `amber`, `red`, `purple` |
| `data.priority` | string |  | one of: `low`, `normal`, `high`, `urgent` |
| `data.tags` | string[] |  |  |
| `data.due` | string |  | The due time, or null. |
| `data.assignee` | object |  | The member it is assigned to, or null. |
| `data.assignee.id` | integer |  |  |
| `data.assignee.name` | string |  |  |
| `data.contact` | object | yes |  |
| `data.contact.identity` | string |  | The submitter's WhatsApp number (digits, country code first) or business-scoped user id. Empty for a web submission with only an e-mail address. |
| `data.contact.name` | string |  |  |
| `data.contact.phone` | string |  |  |
| `data.contact.email` | string |  |  |
| `data.contact.verified` | boolean |  | true: the number is proven (sent on WhatsApp, or confirmed from the web page with one message). |
| `data.conversation_id` | integer |  | The WhatsApp conversation. 0 when there is none. |
| `data.answers` | object | yes | What was asked: field key -> value. The value's JSON type follows the field type (text: string, number and rating: number, yesno and consent: boolean, multiselect: array of choice ids, photo and document: array of file ids, date: YYYY-MM-DD, location: the address text).; any keys |
| `data.extra` | object |  | Everything that was not asked: internal fields, calculated values and values automations saved.; any keys |
| `data.location` | object |  | The pin the submitter sent, or null. |
| `data.location.lat` | number |  |  |
| `data.location.lng` | number |  |  |
| `data.location.name` | string |  |  |
| `data.location.address` | string |  |  |
| `data.parent` | string |  | The reference of the submission this one adds to (a follow-up form), or null. |
| `data.summary` | string |  | One line for lists: the first answers. |
| `data.files_count` | integer |  |  |
| `data.files_pending` | integer |  | Files of the WhatsApp form that are still being fetched. 0 = all stored. |
| `data.unread` | boolean |  | New, or the submitter added something staff have not opened yet. |
| `data.link` | string |  | The submitter's own page: status, history, add information. No login; treat it as a secret of the submitter. |
| `data.created` | string |  |  |
| `data.updated` | string |  |  |
| `data.status_changed` | string |  |  |
| `data.closed` | string |  | When it reached a done or cancelled stage, or null. |
| `data.deleted` | string |  | Only on a deleted submission: when it was deleted. |
| `data.files` | object[] |  | One submission only (and webhook events). |
| `data.files.id` | integer |  | What a photo or document answer holds. |
| `data.files.field` | string |  | The field it belongs to. Empty: added afterwards. |
| `data.files.name` | string |  |  |
| `data.files.mime` | string |  |  |
| `data.files.size` | integer |  | Bytes. |
| `data.files.state` | string |  | pending: still being fetched from WhatsApp. failed: could not be fetched.; one of: `pending`, `stored`, `failed` |
| `data.files.source` | string |  | flow: the WhatsApp form. chat: sent in the chat afterwards.; one of: `flow`, `web`, `chat`, `staff`, `api` |
| `data.files.url` | string |  | Fetches the file's bytes without a key. Valid for 7 days from this answer; read the submission again for a fresh one. Empty until the file is stored. |
| `data.files.created` | string |  |  |
| `data.buttons` | object[] |  | Buttons sent to the submitter that they have not pressed yet. One submission only (and webhook events). |
| `data.buttons.id` | string |  |  |
| `data.buttons.title` | string |  |  |
| `data.reply` | object | yes |  |
| `data.reply.text` | string |  | What they wrote. |
| `data.reply.files` | integer[] |  | The ids of the files they added (the objects are in files). |
| `data.reply.button` | string |  | The id of the button they pressed. Empty when none. |
| `data.reply.followup` | string |  | Only when they sent a follow-up form: the reference of that new submission (its parent is this one). |

## Samples

### photo added

```json
{
  "id": "evt_Sub3k9m2Lw8Rt5Yp1Zs07",
  "type": "submission.customer_replied",
  "created": "2026-11-13T04:20:00.000Z",
  "number": "4976659348270",
  "data": {
    "id": 4182,
    "reference": "MR-7Q3M2A",
    "form": {
      "key": "meter_reading",
      "name": "Meter reading"
    },
    "channel": "whatsapp",
    "status": "received",
    "status_name": "Received",
    "status_kind": "open",
    "status_color": "blue",
    "priority": "normal",
    "tags": [
      "north"
    ],
    "due": null,
    "assignee": null,
    "contact": {
      "identity": "61412345678",
      "name": "Sample Contact",
      "phone": "61412345678",
      "email": "",
      "verified": true
    },
    "conversation_id": 8762,
    "answers": {
      "meter_no": "A-1182",
      "reading": 48213,
      "photo": [
        9917
      ]
    },
    "extra": {
      "usage": 312
    },
    "location": null,
    "parent": null,
    "summary": "A-1182 · 48213",
    "files_count": 2,
    "files_pending": 0,
    "unread": true,
    "link": "https://www.app2email.com/s/4mXk9QpL2vTz8RwY3nBc6HdJ5sFg7Ka1",
    "created": "2026-11-13T04:00:00.000Z",
    "updated": "2026-11-13T04:20:00.000Z",
    "status_changed": "2026-11-13T04:00:00.000Z",
    "closed": null,
    "files": [
      {
        "id": 9917,
        "field": "photo",
        "name": "IMG_5237.jpg",
        "mime": "image/jpeg",
        "size": 281733,
        "state": "stored",
        "source": "flow",
        "url": "https://api.app2email.com/submit/file/c2FtcGxlLWZpbGUtbGluay1ub3QtcmVhbA",
        "created": "2026-11-13T04:00:00.000Z"
      },
      {
        "id": 9918,
        "field": "photo",
        "name": "IMG_5240.jpg",
        "mime": "image/jpeg",
        "size": 281733,
        "state": "stored",
        "source": "chat",
        "url": "https://api.app2email.com/submit/file/c2FtcGxlLWZpbGUtbGluay1ub3QtcmVhbA",
        "created": "2026-11-13T04:20:00.000Z"
      }
    ],
    "buttons": [],
    "reply": {
      "text": "Here is a clearer photo of the meter.",
      "files": [
        9918
      ],
      "button": ""
    }
  }
}
```

## Caused by

- [Message the submitter, with up to 3 buttons](https://www.app2email.com/docs/api/submit-info/reply-to-submission.md): `POST /v1/{number}/submit/submissions/{id}/reply`

Send it to your URL: https://www.app2email.com/docs/api/webhooks/tester?type=submission.customer_replied
