Contendar Help

Create submission

Create an NPS submission. Use this to record a score you collected somewhere else.

POST /nps/submissions

The category is set for you from the score. The source is always form.

Authentication

Send your API key as a bearer token. See Authentication .

Request body

FieldTypeRequiredNotes
projectIdUUIDyesThe project to add the score to.
formBuilderIdUUIDyesThe NPS form the score belongs to.
scoreintegeryes0 to 10.
commentstringnoA free text comment.
customerIdUUIDnoLink the score to a customer.
{
  "projectId": "8a7b6c5d-4e3f-2a1b-0c9d-8e7f6a5b4c3d",
  "formBuilderId": "1f2e3d4c-5b6a-7980-1234-56789abcdef0",
  "score": 9,
  "comment": "Would recommend to any marketing team."
}

Response

Returns the created submission. See List NPS submissions for the meaning of each field.

{
  "npsSubmissionId": "e4a3f6d5-9c7b-4e1d-8f4a-5b6c7d8e9f0a",
  "projectId": "8a7b6c5d-4e3f-2a1b-0c9d-8e7f6a5b4c3d",
  "formBuilderId": "1f2e3d4c-5b6a-7980-1234-56789abcdef0",
  "customerId": null,
  "score": 9,
  "comment": "Would recommend to any marketing team.",
  "category": "promoter",
  "status": "active",
  "source": "form",
  "createdAt": "2026-08-29T12:00:00.000Z",
  "updatedAt": "2026-08-29T12:00:00.000Z"
}

Example

curl -X POST "https://app.contendar.com/api/v1/nps/submissions" \
  -H "Authorization: Bearer ck_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "YOUR_PROJECT_ID",
    "formBuilderId": "YOUR_FORM_ID",
    "score": 9,
    "comment": "Would recommend to any marketing team."
  }'

Related pages

Was this helpful?