> ## Documentation Index
> Fetch the complete documentation index at: https://developer.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NPS

NPS stands for *Net Promoter Score*. This is a common metric used in customer experience programs. A customer's NPS measures a customer's loyalty by looking at how likely they are to recommend a given business. It is given as an number on a scale of 1 to 10.

<Tip>
  The NPS endpoint is only available in the Engage v3 API.
</Tip>

## Adding NPS for contact

An NPS score can be added for a specific contact using the following v3 endpoint:

```http theme={null}
POST /api/v3/contacts/{contactId}/createNpsResponse
```

<ResponseField name="contactId" type="GUID" required>
  Unique identifier of the contact, added in the path as shown.
</ResponseField>

<ResponseField name="grade" type="int" required>
  Sent in query string. The actual NPS value for this contact, from 1 - 10.
</ResponseField>

An example request would then be:

```http Example request theme={null}
POST /api/v3/contacts/2e40b702-2767-4abe-ae99-aa510108e22b/createNpsResponse?grade=5
```

## Responses

The possible responses from this request are:

* *200 OK*: The POST was successful and the NPS value was saved for the contact.

* *400* InvalidGrade: The grade value was missing or not in the allowed range.

* *404* ContactNotFound: No contact was found with the given `contactId`.