diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index 75f8ca93..fd58e20f 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -6,9 +6,60 @@ Change history
 =====
 *TBD*
 
+2.5.0 (2025-01-08)
+------------------
+
 **New features**
 
-* Updated OAF version to 0.9.0. This upgrade allows admin users managing their sessions through the admin.
+* added support for configuring permissions through ``django-setup-configuration``
+  version ``0.4.0`` [#497]
+* added support for configuring token authorizations through ``django-setup-configuration``
+  version ``0.4.0`` [#485]
+* added support for configuring ``mozilla-django-oidc-db`` through ``django-setup-configuration``
+  version ``0.4.0`` [#490]
+* added support for configuring ``OBJECTTYPE``'s through ``django-setup-configuration``
+  version ``0.4.0`` [#467]
+* added support for configuring Notificatiescomponentconfiguratie through ``django-setup-configuration``
+  version ``0.4.0`` [#484]
+* added the new ``data_attrs`` query parameter for the ``OBJECT``'s resource [#472]
+
+.. warning::
+
+    Usage of the `data_attr` query parameter is deprecated. Usage of the
+    new `data_attrs` query parameter is recommended.
+
+* updated OAF version to 0.9.1. This upgrade allows admin users managing their sessions through the admin.
+
+**Bugfixes and QOL**
+
+* fixed ``latest`` docker image tag not being pushed [open-api-framework/#92]
+* fixed documentation building in CI [#501]
+* included ``gettext`` in docker images [#495]
+* updated zgw-consumers to 0.35.1 [open-api-framework/#66]
+
+.. warning::
+
+    Configuring external services is now done through the ``Service`` model. This
+    replaces the ``APICredential`` model in the admin interface. A data migration
+    was added to move to the `Service` model. It is advised to verify the ``Service``
+    instances in the admin to check that the data migration was ran as expected.
+
+* updated PATCH request behaviour for the ``data`` field [#466]
+* added documentation for notification retry behavior [#403]
+* fixed CSP errors [open-api-framework/#68]
+* removed objects-api v1. V2 is the only supported version as of now. [#453]
+* fixed token permissions admin [#449]
+* fixed `NOTIFICATIONS_ENABLED` setting having an incorrect value [#452]
+
+**Project maintenance**
+
+* implementend CI action to create a PR with latest OAF version [open-api-framework/#44]
+* security updates [open-api-framework/#93]
+* switched from ``pip-compile`` to ``uv`` [open-api-framework/#81]
+* re-enabled Trivy image scanning [#463]
+* pinned ``publish`` workflow to ``v3.0.1`` [#504]
+* implementend open-api-workflows [open-api-framework/#13]
+* added missing changelog entry [#455]
 
 
 2.4.3 (2024-09-18)
diff --git a/README.rst b/README.rst
index 85b2e75f..105e8c68 100644
--- a/README.rst
+++ b/README.rst
@@ -36,7 +36,10 @@ Version         Release date    API specification
 ==============  ==============  =============================
 latest          n/a             `ReDoc <https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/maykinmedia/objects-api/master/src/objects/api/v2/openapi.yaml>`_,
                                 `Swagger <https://petstore.swagger.io/?url=https://raw.githubusercontent.com/maykinmedia/objects-api/master/src/objects/api/v2/openapi.yaml>`_,
-                                (`diff <https://github.com/maykinmedia/objects-api/compare/2.4.3..master#diff-b9c28fec6c3f3fa5cff870d24601d6ab7027520f3b084cc767aefd258cb8c40a>`_)
+                                (`diff <https://github.com/maykinmedia/objects-api/compare/2.5.0..master>`_)
+2.5.0           2025-01-08      `ReDoc <https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/maykinmedia/objects-api/2.5.0/src/objects/api/v2/openapi.yaml>`_,
+                                `Swagger <https://petstore.swagger.io/?url=https://raw.githubusercontent.com/maykinmedia/objects-api/2.5.0/src/objects/api/v2/openapi.yaml>`_
+                                (`diff <https://github.com/maykinmedia/objects-api/compare/2.4.3..2.5.0>`_)
 2.4.3           2024-03-22      `ReDoc <https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/maykinmedia/objects-api/2.4.3/src/objects/api/v2/openapi.yaml>`_,
                                 `Swagger <https://petstore.swagger.io/?url=https://raw.githubusercontent.com/maykinmedia/objects-api/2.4.3/src/objects/api/v2/openapi.yaml>`_
                                 (`diff <https://github.com/maykinmedia/objects-api/compare/2.3.0..2.4.3#diff-b9c28fec6c3f3fa5cff870d24601d6ab7027520f3b084cc767aefd258cb8c40a>`_)