---
title: "Push email-delivery stats for a feedback form"
method: POST
path: "/feedback/feedback_form/stats"
tags: ["Feedback Management"]
---

# Push email-delivery stats for a feedback form

`POST /feedback/feedback_form/stats`

<Warning>
The Feedback Management API is currently in **BETA**, therefore the following endpoints are subject to modification, given a **2 week notice**.

If you are planning to use any of them, please **notify us** so we will be able to keep you informed about upcoming changes.
</Warning>

This endpoint lets you push one day of email-delivery funnel metrics (sent, delivered, opened,
clicked, bounced) for a feedback form and business, typically reported by your Email Service
Provider (ESP).

It upserts on `(feedback_form_id, business_id, date)`: `sent` and `clicked` always overwrite
the row, while the optional metrics (`processed`, `delivered`, `opened`, `bounced`) keep their
previous value when omitted or `null`, defaulting to `0` only on a brand-new row.

Rows created here are always stored with `source: external`, and feed the `survey.sent`,
`survey.delivered`, `survey.opened`, `survey.clicked` and `survey.error_bounces`
[analytics metrics](/api-reference/feedback-analytics/feedback-analytics-metrics).

## Request body

- object
  - `feedback_form_id` string, required — The unique identifier of the form
  - `business_id` string, required — Business id
  - `date` string, date, required — Day these metrics apply to
  - `sent` integer, required — Number of survey emails sent
  - `clicked` integer, required — Number of survey link clicks (from the email)
  - `processed` integer, nullable — Number of survey emails accepted for delivery by the ESP. Omit or send `null` to leave unchanged.
  - `delivered` integer, nullable — Number of survey emails successfully delivered. Omit or send `null` to leave unchanged.
  - `opened` integer, nullable — Number of survey emails opened. Omit or send `null` to leave unchanged.
  - `bounced` integer, nullable — Number of survey emails that bounced. Omit or send `null` to leave unchanged.

## Response `200`

OK

- FeedbackFormStats — One day of email-delivery funnel metrics for a (feedback_form, business) pair.
  - `feedback_form_id` string — The unique identifier of the form
  - `business_id` string — Business id
  - `date` string, date — Day these metrics apply to
  - `source` 'external' | 'internal' — Origin of the emailing volume. Always `external` for rows created through this endpoint (i.e. reported by your ESP).
  - `org_id` integer — The organization ID the feedback form belongs to
  - `sent` integer — Number of survey emails sent
  - `processed` integer — Number of survey emails accepted for delivery by the ESP
  - `delivered` integer — Number of survey emails successfully delivered
  - `opened` integer — Number of survey emails opened
  - `clicked` integer — Number of survey link clicks (from the email)
  - `error_bounces` integer — Number of survey emails that bounced

## Other responses

- `400` — Your request is incorrect
- `401` — You are not authenticated
- `404` — Resource does not exist

---

[API](https://skmtc.net/partoo/apis/partoo-rest-api.md) · [All operations](https://skmtc.net/partoo/apis/partoo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/partoo/partoo-rest-api/revisions/3652d8b1a8b3/schema)