Note: The Net Promoter Score℠ (NPS®) API is deprecated. Zendesk is removing NPS survey functionality on April 30, 2023. For more information, see Announcing the removal of Net Promoter Score (NPS).


Beyond just being a customer service platform, Zendesk Support is also a place where you can go to learn about your customers and engage with them in a way that’s more meaningful, personal, and productive. One of the ways Zendesk Support enables companies to draw out customer insights is through our NPS surveys.

NPS is essentially a metric that measures customer loyalty with your brand. Through a one-question survey that asks “How likely are you to recommend Acme Company to someone you know?”, you can measure customer sentiment and gather valuable feedback about your company, products, and service.

While you can send NPS surveys within the Zendesk Support web interface, you can also tap into our API to automatically send these surveys based off of an event that occurs in your product or service. For example, many retailers often choose to send an NPS survey to a customer after an order has been fulfilled in order to capture a customer’s feedback about his or her entire experience with the brand at the most opportune time.

Via the NPS API, you can define the recipients of an NPS survey campaign, when they are offered the survey, and export the survey results for reporting and analysis.

See the API documentation for general information on Zendesk APIs, such as authentication, rate limits, and pagination.

How NPS surveys work

Every NPS survey campaign has a unique survey ID. Under each survey campaign, there can be multiple invitations—each represented by unique invitation IDs. You can send invitations to one or multiple recipients to take an NPS survey. If a survey is delivered successfully (for example, no bounce), the NPS survey is emailed to a recipient, who is represented by a unique recipient ID. If the recipient responds to the survey, the recipient will then become a user in Zendesk Support if he or she did not exist before. The user will have a unique ID, and the user’s NPS rating and comment will be captured.

NPS API visual flow chart

Customizing and setting up your NPS survey

You can customize the look-and-feel of the NPS survey to match your company’s brand. In Zendesk Support:

  1. Start by navigating to Reporting (Reporting icon).
  2. Select the tab titled Net Promoter Score℠.
  3. Select Send New Survey.
  4. Customize the email survey by adding a logo and changing the accent color.
  5. You can also customize the follow-up question on the confirmation page.
  6. When you’re happy with the look-and-feel, click Start Survey.
  7. Copy/paste the survey ID and use this ID in the API when creating a new invitation.

Net Promoter, NPS, and the NPS-related emoticons are registered trademarks, and Net Promoter Score and Net Promoter System are service marks, of Bain & Company, Inc., Satmetrix Systems, Inc. and Fred Reichheld.

Run in Postman

If you use Postman, you can import the NPS® API endpoints as a collection into your Postman app, then try out different requests to learn how the API works. Click the following button to get started:

Run in Postman

If you don't use Postman, you can sign up for a free account on the Postman website and download the app. For more information about using Postman with Zendesk APIs, see Exploring Zendesk APIs with Postman.