[Python SDK] Release 2.0.0

SinchSDKTeam — Wed, 01 Apr 2026 09:56:48 GMT

What's Changed

[design] Requires explicit sms_region and conversation_region on SinchClient before 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 SinchClient is supported (#55).
[feature] Automatic pagination via a shared Paginator pattern 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 (wires callback_url), and a sinch_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). groups and inbounds are 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).