---
id: sunshine-conversations-client
version: "17.0.1"
license: unclear
license_treatment: unclear
maintenance: aging
---

# sunshine-conversations-client — Sunshine Conversations API

License: unclear · Maintenance: aging · Downloads: 884.9K/mo

## What it is and what it does

This is an auto-generated Python wrapper around the Sunshine Conversations REST API v2, maintained by Zendesk. It provides typed client classes and methods to interact with Zendesk's messaging platform, handling authentication (basic auth or JWT), request/response serialization, and HTTP communication via urllib3. The library is built on pydantic for data validation and python-dateutil for timestamp handling.

The package is intended for server-to-server integrations where you need to programmatically manage conversations, users, attachments, and webhooks within a Zendesk Sunshine Conversations account. It abstracts away the low-level REST details, but you still need to understand the API's authorization scopes (account, app, or integration), rate limits, and regional host configuration to use it effectively.

Use it for:

- Build a backend service that creates or retrieves conversations and sends messages on behalf of your application.
- Automate user provisioning and management across multiple Zendesk Sunshine Conversations accounts.
- Fetch conversation history and metadata for reporting, analytics, or compliance audits.
- Integrate Sunshine Conversations with external systems by consuming or posting webhook events.
- Manage attachments and media uploads programmatically within conversations.

## Worth the install?

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

Python client library for the Sunshine Conversations API v2, enabling programmatic access to REST endpoints for messaging, conversations, and user management.

Yes, if you are actively using Zendesk Sunshine Conversations and need a Python SDK to automate API interactions. The low install friction and absence of known vulnerabilities make it safe to add. However, verify the license terms before production use, and be aware that the 344-day gap since last release may mean slower response to API changes or bugs—monitor the project's repository for activity and consider whether the aging maintenance status aligns with your support expectations.

## Install

pip install sunshine-conversations-client
uv add sunshine-conversations-client
poetry add sunshine-conversations-client

## Installing sunshine-conversations-client

Before you install: Low install friction with a pure-Python wheel distribution and four lightweight runtime dependencies. Maintenance status is aging—the package was last released 344 days ago, which may indicate slower update cadence for bug fixes or API changes.

License in practice: License treatment is unclear; the package declares no SPDX identifier or raw license text in its metadata. Before using in production, verify the actual license terms from the project repository or contact the maintainer.

Quickstart:

pip install sunshine-conversations-client

from sunshine_conversations_client import ApiClient, Configuration

config = Configuration(api_key_id='your_key_id', api_key_secret='your_key_secret')
client = ApiClient(configuration=config)

Requires valid Sunshine Conversations API credentials (key ID and secret) and knowledge of the appropriate API host URL for your region or Zendesk subdomain.

Verify before relying:

- Whether the package supports both v1 and v2 API versions, or only v2 as the description suggests.
- Actual Python version compatibility, since requires_python is unspecified in metadata.
- Whether cursor-based pagination and error handling are fully implemented in the client wrapper.
- Current maintenance status and whether the 344-day gap reflects active support or dormancy.

## Package facts

- License: not declared (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 884.9K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sunshine conversations api client, zendesk messaging api python, rest api client messaging, conversation management sdk, zendesk conversations python, smooch api client, messaging platform api wrapper, zendesk-integration, rest-client, messaging-api

[View on SkillFed](https://skillfed.io/packages/sunshine-conversations-client) · [View on PyPI](https://pypi.org/project/sunshine-conversations-client/)