Record NPS response
POST/support/nps-campaigns/{id}/responses
Records a single NPS response from a customer for a given campaign. Provide the numeric score (0–10) and an optional comment. Use this when ingesting survey responses from external channels or webhooks.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | ID of the NPS campaign this response belongs to. Example: |
Request body
Content type application/json (required).
| Field | Type | Required | Description |
|---|---|---|---|
score | integer | Yes | NPS score from 0 (detractor) to 10 (promoter). Minimum: 0 · Maximum: 10 |
comment | string, nullable | No | Optional open-text feedback from the respondent. |
respondent_email | string (email), nullable | No | Email address of the respondent for attribution. |
Example
{
"score": 8,
"comment": "Great support team, very responsive!",
"respondent_email": "customer@example.test"
}
Responses
302 Redirect after response is recorded
404 NPS campaign not found
422 Validation error — score must be 0–10
Example request
curl -X POST "https://{tenant}.faciotech.net/api/v1/support/nps-campaigns/{id}/responses" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"score": 8, "comment": "Great support team, very responsive!", "respondent_email": "customer@example.test"}'