diff --git a/devel/py-azure-mgmt-iothub/Makefile b/devel/py-azure-mgmt-iothub/Makefile
index 619b018966b4..05aca610910e 100644
--- a/devel/py-azure-mgmt-iothub/Makefile
+++ b/devel/py-azure-mgmt-iothub/Makefile
@@ -1,23 +1,28 @@
 PORTNAME=	azure-mgmt-iothub
-PORTVERSION=	3.0.0
-PORTREVISION=	1
+DISTVERSION=	5.0.0b2
 CATEGORIES=	devel python
 MASTER_SITES=	PYPI
 PKGNAMEPREFIX=	${PYTHON_PKGNAMEPREFIX}
+DISTNAME=	azure_mgmt_iothub-${DISTVERSION}
 
 MAINTAINER=	sunpoet@FreeBSD.org
-COMMENT=	Microsoft Azure IoTHub Management Client Library for Python
-WWW=		https://pypi.org/project/azure-mgmt-iothub/
+COMMENT=	Microsoft Azure IoT Hub Management Client Library for Python
+WWW=		https://azure.github.io/azure-sdk-for-python/ \
+		https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/iothub/azure-mgmt-iothub \
+		https://github.com/Azure/azure-sdk-for-python
 
 LICENSE=	MIT
+LICENSE_FILE=	${WRKSRC}/LICENSE
 
-RUN_DEPENDS=	${PYTHON_PKGNAMEPREFIX}msrest>=0.7.1:net-mgmt/py-msrest@${PY_FLAVOR} \
-		${PYTHON_PKGNAMEPREFIX}azure-common>=1.1:www/py-azure-common@${PY_FLAVOR} \
-		${PYTHON_PKGNAMEPREFIX}azure-core>=1.3.2<2.0.0:devel/py-azure-core@${PY_FLAVOR}
+BUILD_DEPENDS=	${PYTHON_PKGNAMEPREFIX}setuptools>=0:devel/py-setuptools@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}wheel>=0:devel/py-wheel@${PY_FLAVOR}
+RUN_DEPENDS=	${PYTHON_PKGNAMEPREFIX}azure-mgmt-core>=1.6.0:devel/py-azure-mgmt-core@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}msrest>=0.7.1:net-mgmt/py-msrest@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}typing-extensions>=4.6.0:devel/py-typing-extensions@${PY_FLAVOR}
 
-USES=		azurepy python
-USE_PYTHON=	autoplist concurrent distutils
+USES=		python
+USE_PYTHON=	autoplist concurrent pep517
 
 NO_ARCH=	yes
 
 .include <bsd.port.mk>
diff --git a/devel/py-azure-mgmt-iothub/distinfo b/devel/py-azure-mgmt-iothub/distinfo
index 1d9c8e635264..1e902ddad515 100644
--- a/devel/py-azure-mgmt-iothub/distinfo
+++ b/devel/py-azure-mgmt-iothub/distinfo
@@ -1,3 +1,3 @@
-TIMESTAMP = 1703610916
-SHA256 (azure-mgmt-iothub-3.0.0.tar.gz) = daf21fc98c68a353ec616318c0e62be04c8d6899960be8c2cbf991673ac8b722
-SIZE (azure-mgmt-iothub-3.0.0.tar.gz) = 887095
+TIMESTAMP = 1772028534
+SHA256 (azure_mgmt_iothub-5.0.0b2.tar.gz) = aed49934946a8e83059edc730443182dee4d935a59ce967f7d0299785a16bcf5
+SIZE (azure_mgmt_iothub-5.0.0b2.tar.gz) = 92797
diff --git a/devel/py-azure-mgmt-iothub/files/patch-pyproject.toml b/devel/py-azure-mgmt-iothub/files/patch-pyproject.toml
new file mode 100644
index 000000000000..72b318be2823
--- /dev/null
+++ b/devel/py-azure-mgmt-iothub/files/patch-pyproject.toml
@@ -0,0 +1,19 @@
+--- pyproject.toml.orig	2025-10-20 06:23:48 UTC
++++ pyproject.toml
+@@ -1,6 +1,6 @@ requires = [
+ [build-system]
+ requires = [
+-    "setuptools>=77.0.3",
++    "setuptools>=61",
+     "wheel",
+ ]
+ build-backend = "setuptools.build_meta"
+@@ -11,7 +11,7 @@ description = "Microsoft Azure Iothub Management Clien
+     { name = "Microsoft Corporation", email = "azpysdkhelp@microsoft.com" },
+ ]
+ description = "Microsoft Azure Iothub Management Client Library for Python"
+-license = "MIT"
++license = { text = "MIT" }
+ classifiers = [
+     "Development Status :: 4 - Beta",
+     "Programming Language :: Python",
diff --git a/devel/py-azure-mgmt-iothub/pkg-descr b/devel/py-azure-mgmt-iothub/pkg-descr
index bff515cda43c..00fc8f6f0943 100644
--- a/devel/py-azure-mgmt-iothub/pkg-descr
+++ b/devel/py-azure-mgmt-iothub/pkg-descr
@@ -1,4 +1,3 @@
-This is the Microsoft Azure IoTHub Management Client Library.
-
-Azure Resource Manager (ARM) is the next generation of management APIs that
-replace the old Azure Service Management (ASM).
+This is the Microsoft Azure IoT Hub Management Client Library. This package has
+been tested with Python 3.9+. For a more complete view of Azure libraries, see
+the azure sdk python release.