Skip to content

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

NameTypeRequiredDescription
idintegerYes

ID of the NPS campaign this response belongs to.

Example: 2

Request body

Content type application/json (required).

FieldTypeRequiredDescription
scoreintegerYes

NPS score from 0 (detractor) to 10 (promoter).

Minimum: 0 · Maximum: 10

commentstring, nullableNo

Optional open-text feedback from the respondent.

respondent_emailstring (email), nullableNo

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"}'
Loading