---
id: delighted
version: "4.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# delighted — Delighted API Python Client.

License: permissive · Maintenance: active · Downloads: 443.7K/mo

## What it is and what it does

Delighted is the official Python client for the Delighted customer feedback and NPS survey platform. It provides object-oriented access to create survey recipients, schedule surveys with optional delays, collect and update survey responses, manage unsubscribes and bounces, and retrieve satisfaction metrics. The client handles pagination, rate limiting, and timezone-aware date filtering for survey response queries.

The package wraps HTTP requests to the Delighted API using the requests library and manages authentication via an API key. It supports operations like adding people to surveys, deleting pending survey requests, managing autopilot configurations for email and SMS channels, and retrieving metrics with time-range filtering. However, the package is deprecated and will no longer be maintained after June 30, 2026, making it unsuitable for new projects.

Use it for:

- Integrate NPS surveys into a SaaS application by creating survey recipients and collecting satisfaction scores programmatically.
- Batch import customer lists into Delighted and schedule surveys with staggered delays to manage survey volume.
- Retrieve historical survey responses and metrics for a specific date range to analyze customer satisfaction trends.
- Manage survey membership in autopilot campaigns across email and SMS channels, adding or removing recipients dynamically.
- Handle rate-limited API responses gracefully by catching TooManyRequestsError and implementing retry logic with backoff.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client for the Delighted API that manages customer feedback surveys, including creating survey recipients, scheduling surveys, collecting responses, and retrieving satisfaction metrics.

No. Although the package has low install friction and a permissive license, it is explicitly deprecated and will no longer be maintained after June 30, 2026. The underlying Delighted service is being sunset. Existing users should plan migration; new projects should not adopt it.

## Install

pip install delighted
uv add delighted
poetry add delighted

## Installing delighted

Before you install: Low install friction with three stable runtime dependencies (six, requests, tzlocal). However, the package is explicitly deprecated and will no longer be maintained after June 30, 2026—new projects should not adopt it.

License in practice: MIT license permits commercial and private use with minimal restrictions, requiring only attribution and inclusion of the license notice.

Quickstart:

pip install delighted

import delighted
delighted.api_key = 'YOUR_API_KEY'
person = delighted.Person.create(email='user@example.com')
response = delighted.SurveyResponse.create(person=person.id, score=10)

Requires a valid Delighted API key from your account settings; the service is being sunset on June 30, 2026.

Verify before relying:

- Whether the Delighted service itself will remain operational after the June 30, 2026 sunset date, or if API access will be discontinued.
- Current status of the official Delighted API documentation and support availability during the deprecation period.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 443.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

customer satisfaction survey api client, nps survey management python, delighted api integration, survey response collection, customer feedback platform, survey scheduling and tracking, net promoter score automation, survey-api, deprecated-2026, nps

[View on SkillFed](https://skillfed.io/packages/delighted) · [View on PyPI](https://pypi.org/project/delighted/)