All notable changes to the Sinch Python SDK are documented in this file.
Tag legend
[feature]— new capability[fix]— bug fix[deprecation notice]— will be removed in a future release[dependency]— third-party library update[doc]— documentation only[test]— test coverage[refactor]— internal restructuring[releasing]— release infrastructure[design]— API design change[tech]— technical improvement
- [design] Requires explicit
sms_regionandconversation_regiononSinchClientbefore using SMS and Conversation APIs (no silent US/EU defaults); runtime failure if unset (#49, #110). - [design] The v1 asynchronous client and httpx-based async stack were removed; only synchronous
SinchClientis supported (#55). - [feature] Automatic pagination via a shared
Paginatorpattern for paged list APIs (#46, #54). - [doc] README and configuration tests clarify which credentials apply to each API (#48).
- [feature] Messages API refresh: convenience send methods (
send_text_message(),send_card_message(),send_carousel_message(),send_choice_message(),send_contact_info_message(),send_list_message(),send_location_message(),send_media_message(),send_template_message()),list()as a paginator,update(),event_destination_target(wirescallback_url), and asinch_client.conversation.sinch_events(...)helper for inbound event handling (#109–#120). - [feature] Conversation Sinch Events (webhooks) support (#122, #131, #132, #133).
- [design] Conversation webhook REST client removed; handle inbound traffic via Sinch Events (see MIGRATION_GUIDE.md) (#131, #132, #133).
- [feature] Flatter API (
rent,list,event_destinations, and related entry points),event_destination_target, and a Numbers Sinch Events helper (#44, #53, #57, #58, #59, #62). - [feature] Available Regions endpoint (#56).
- [feature] Webhook helper validates the signing secret in
validate_signature_header()(#61). - [tech] Numbers Events payloads are passed through without client-side pre-processing (#63).
- [feature] Number Lookup v1 (lookup API, models, snippets, and E2E coverage) (#99, #101, #104).
- [design] SMS client configuration and authentication paths refactored for project vs service-plan credentials, including delivery-report flows (#90).
- [feature] SMS delivery reports models and pagination (#87).
groupsandinboundsare planned for a future release (see migration guide). - [feature] SMS Sinch Events (webhooks) support (#103).
- [doc] SMS migration guide and Sinch events quickstart material (#107, #108).
- [design] Verification V1 APIs are removed (#124). V2 Verification support is planned in a future release (see MIGRATION_GUIDE.md).
- [design] Voice V1 APIs are removed (#124). V2 Voice support is planned in a future release (see MIGRATION_GUIDE.md).
- [dependency] Pydantic v2 (
pydantic = ">=2.0.0"). - [releasing] Ruff linter adoption (#84) and CI workflow updates (#121).
- [doc] Snippets and Getting Started live under
examples/(#95, #98, #105, #106, #115, #118, #125, #127). - [doc] Docstring updates across Numbers, SMS, and Conversation (#64, #65, #67, #96, #97).
- [refactor] Model, type, and class renames (#60, #70, #82).
- [tech] Conversation, Numbers, and SMS models and endpoints resynchronized with OpenAPI specification (#68, #75, #123, #128, #129, #134, #135).
- [test] E2E test infrastructure and refactoring (#45, #66, #102); SMS batches test coverage (#91, #93, #94).
- [feature] Python 3.13 and 3.14 support (#86, #89).
- [releasing] CI updates (#86, #89).
- [fix] DTMF conference fix (#79).
- [test] End-to-end tests disabled.
- [test] Tests and CI improvements (#41, #42, #43, #74).
- [fix] Async authentication fixes (#41, #42, #43, #74).
- [doc] README link updates.
- [releasing] CI and release-related updates.
- [fix] Remove aiohttp leftovers (#40).
- [releasing] CI strategy updates (#34, #36, #29, #17).
- [feature] Backwards-compatible Verification API update.
- [feature] PyPI publishing and httpx/async HTTP stack.
- [feature] SMS service plan API.
- [feature] Verification API (#26, #27, #28).
- [feature] Voice API (#26, #27, #28).
- [doc] General availability README updates (#26, #27, #28).