Push email-delivery stats for a feedback form

curl --request POST \
  --url https://api.partoo.co/v2/feedback/feedback_form/stats \
  --header 'Content-Type: application/json' \
  --header 'x-APIKey: <api-key>' \
  --data '
{
  "feedback_form_id": "674d791c13c9d976e20001b1",
  "business_id": "5409c35a97bbc544d8e26737",
  "date": "2026-06-01",
  "sent": 100,
  "clicked": 10,
  "processed": 95,
  "delivered": 90,
  "opened": 50,
  "bounced": 5
}
'

import requests

url = "https://api.partoo.co/v2/feedback/feedback_form/stats"

payload = {
    "feedback_form_id": "674d791c13c9d976e20001b1",
    "business_id": "5409c35a97bbc544d8e26737",
    "date": "2026-06-01",
    "sent": 100,
    "clicked": 10,
    "processed": 95,
    "delivered": 90,
    "opened": 50,
    "bounced": 5
}
headers = {
    "x-APIKey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-APIKey': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    feedback_form_id: '674d791c13c9d976e20001b1',
    business_id: '5409c35a97bbc544d8e26737',
    date: '2026-06-01',
    sent: 100,
    clicked: 10,
    processed: 95,
    delivered: 90,
    opened: 50,
    bounced: 5
  })
};

fetch('https://api.partoo.co/v2/feedback/feedback_form/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.partoo.co/v2/feedback/feedback_form/stats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'feedback_form_id' => '674d791c13c9d976e20001b1',
    'business_id' => '5409c35a97bbc544d8e26737',
    'date' => '2026-06-01',
    'sent' => 100,
    'clicked' => 10,
    'processed' => 95,
    'delivered' => 90,
    'opened' => 50,
    'bounced' => 5
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-APIKey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.partoo.co/v2/feedback/feedback_form/stats"

	payload := strings.NewReader("{\n  \"feedback_form_id\": \"674d791c13c9d976e20001b1\",\n  \"business_id\": \"5409c35a97bbc544d8e26737\",\n  \"date\": \"2026-06-01\",\n  \"sent\": 100,\n  \"clicked\": 10,\n  \"processed\": 95,\n  \"delivered\": 90,\n  \"opened\": 50,\n  \"bounced\": 5\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-APIKey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.partoo.co/v2/feedback/feedback_form/stats")
  .header("x-APIKey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"feedback_form_id\": \"674d791c13c9d976e20001b1\",\n  \"business_id\": \"5409c35a97bbc544d8e26737\",\n  \"date\": \"2026-06-01\",\n  \"sent\": 100,\n  \"clicked\": 10,\n  \"processed\": 95,\n  \"delivered\": 90,\n  \"opened\": 50,\n  \"bounced\": 5\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.partoo.co/v2/feedback/feedback_form/stats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-APIKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"feedback_form_id\": \"674d791c13c9d976e20001b1\",\n  \"business_id\": \"5409c35a97bbc544d8e26737\",\n  \"date\": \"2026-06-01\",\n  \"sent\": 100,\n  \"clicked\": 10,\n  \"processed\": 95,\n  \"delivered\": 90,\n  \"opened\": 50,\n  \"bounced\": 5\n}"

response = http.request(request)
puts response.read_body

{
  "feedback_form_id": "674d791c13c9d976e20001b1",
  "business_id": "5409c35a97bbc544d8e26737",
  "date": "2026-06-01",
  "source": "external",
  "org_id": 42,
  "sent": 100,
  "processed": 95,
  "delivered": 90,
  "opened": 50,
  "clicked": 10,
  "error_bounces": 5
}

{
  "errors": {
    "json": {}
  }
}

{
  "errors": {
    "authentication": "User not authenticated"
  }
}

{
  "errors": {
    "json": "Resource not found"
  }
}

Feedback Management

Push email-delivery stats for a feedback form

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.

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.

POST

feedback

feedback_form

stats

Push email-delivery stats for a feedback form

curl --request POST \
  --url https://api.partoo.co/v2/feedback/feedback_form/stats \
  --header 'Content-Type: application/json' \
  --header 'x-APIKey: <api-key>' \
  --data '
{
  "feedback_form_id": "674d791c13c9d976e20001b1",
  "business_id": "5409c35a97bbc544d8e26737",
  "date": "2026-06-01",
  "sent": 100,
  "clicked": 10,
  "processed": 95,
  "delivered": 90,
  "opened": 50,
  "bounced": 5
}
'

import requests

url = "https://api.partoo.co/v2/feedback/feedback_form/stats"

payload = {
    "feedback_form_id": "674d791c13c9d976e20001b1",
    "business_id": "5409c35a97bbc544d8e26737",
    "date": "2026-06-01",
    "sent": 100,
    "clicked": 10,
    "processed": 95,
    "delivered": 90,
    "opened": 50,
    "bounced": 5
}
headers = {
    "x-APIKey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-APIKey': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    feedback_form_id: '674d791c13c9d976e20001b1',
    business_id: '5409c35a97bbc544d8e26737',
    date: '2026-06-01',
    sent: 100,
    clicked: 10,
    processed: 95,
    delivered: 90,
    opened: 50,
    bounced: 5
  })
};

fetch('https://api.partoo.co/v2/feedback/feedback_form/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.partoo.co/v2/feedback/feedback_form/stats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'feedback_form_id' => '674d791c13c9d976e20001b1',
    'business_id' => '5409c35a97bbc544d8e26737',
    'date' => '2026-06-01',
    'sent' => 100,
    'clicked' => 10,
    'processed' => 95,
    'delivered' => 90,
    'opened' => 50,
    'bounced' => 5
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-APIKey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.partoo.co/v2/feedback/feedback_form/stats"

	payload := strings.NewReader("{\n  \"feedback_form_id\": \"674d791c13c9d976e20001b1\",\n  \"business_id\": \"5409c35a97bbc544d8e26737\",\n  \"date\": \"2026-06-01\",\n  \"sent\": 100,\n  \"clicked\": 10,\n  \"processed\": 95,\n  \"delivered\": 90,\n  \"opened\": 50,\n  \"bounced\": 5\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-APIKey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.partoo.co/v2/feedback/feedback_form/stats")
  .header("x-APIKey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"feedback_form_id\": \"674d791c13c9d976e20001b1\",\n  \"business_id\": \"5409c35a97bbc544d8e26737\",\n  \"date\": \"2026-06-01\",\n  \"sent\": 100,\n  \"clicked\": 10,\n  \"processed\": 95,\n  \"delivered\": 90,\n  \"opened\": 50,\n  \"bounced\": 5\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.partoo.co/v2/feedback/feedback_form/stats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-APIKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"feedback_form_id\": \"674d791c13c9d976e20001b1\",\n  \"business_id\": \"5409c35a97bbc544d8e26737\",\n  \"date\": \"2026-06-01\",\n  \"sent\": 100,\n  \"clicked\": 10,\n  \"processed\": 95,\n  \"delivered\": 90,\n  \"opened\": 50,\n  \"bounced\": 5\n}"

response = http.request(request)
puts response.read_body

{
  "feedback_form_id": "674d791c13c9d976e20001b1",
  "business_id": "5409c35a97bbc544d8e26737",
  "date": "2026-06-01",
  "source": "external",
  "org_id": 42,
  "sent": 100,
  "processed": 95,
  "delivered": 90,
  "opened": 50,
  "clicked": 10,
  "error_bounces": 5
}

{
  "errors": {
    "json": {}
  }
}

{
  "errors": {
    "authentication": "User not authenticated"
  }
}

{
  "errors": {
    "json": "Resource not found"
  }
}

Authorizations

x-APIKey

string

header

required

The authentication system on Partoo API is using API Key that should be put in the header of the request (the name of the header is x-APIKey). An api_key is linked to a user. This user's role will give you different access level to the API features.

Body

application/json

feedback_form_id

string

required

The unique identifier of the form

Example:

"674d791c13c9d976e20001b1"

business_id

string

required

Business id

Example:

"5409c35a97bbc544d8e26737"

date

string<date>

required

Day these metrics apply to

Example:

"2026-06-01"

sent

integer

required

Number of survey emails sent

Required range: x >= 0

Example:

100

clicked

integer

required

Number of survey link clicks (from the email)

Required range: x >= 0

Example:

10

processed

integer | null

Number of survey emails accepted for delivery by the ESP. Omit or send null to leave unchanged.

Required range: x >= 0

Example:

95

delivered

integer | null

Number of survey emails successfully delivered. Omit or send null to leave unchanged.

Required range: x >= 0

Example:

90

opened

integer | null

Number of survey emails opened. Omit or send null to leave unchanged.

Required range: x >= 0

Example:

50

bounced

integer | null

Number of survey emails that bounced. Omit or send null to leave unchanged.

Required range: x >= 0

Example:

5

Response

One day of email-delivery funnel metrics for a (feedback_form, business) pair.

feedback_form_id

string

The unique identifier of the form

Example:

"674d791c13c9d976e20001b1"

business_id

string

Business id

Example:

"5409c35a97bbc544d8e26737"

date

string<date>

Day these metrics apply to

Example:

"2026-06-01"

source

enum<string>

Origin of the emailing volume.

Always external for rows created through this endpoint (i.e. reported by your ESP).

Available options:

external,

internal

Example:

"external"

org_id

integer

The organization ID the feedback form belongs to

Example:

42

sent

integer

Number of survey emails sent

Required range: x >= 0

Example:

100

processed

integer

Number of survey emails accepted for delivery by the ESP

Required range: x >= 0

Example:

95

delivered

integer

Number of survey emails successfully delivered

Required range: x >= 0

Example:

90

opened

integer

Number of survey emails opened

Required range: x >= 0

Example:

50

clicked

integer

Number of survey link clicks (from the email)

Required range: x >= 0

Example:

10

error_bounces

integer

Number of survey emails that bounced

Required range: x >= 0

Example:

5

Update a feedback form Search for feedback results

⌘I

ApiKeys

Businesses

Business Fields

Categories

Connection Tokens

Messages

Custom Channels

Message Reply Templates

Messaging Settings

Custom Fields

Custom Fields Section

Custom Roles

Google

Groups and Sections

Holidays

Organizations

Posts

Place Action Links

Presence

Reviews

Presence analytics

Review analytics

Review Booster

Subscriptions

Users

Feedback Management

Feedback analytics

Webhooks

Webhooks Events

Push email-delivery stats for a feedback form

Authorizations

Body

Response