diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index 6dbab866e..8cb7c4f37 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -19,6 +19,22 @@ The format is based on `Keep a Changelog`_.
 `UNRELEASED`_
 ^^^^^^^^^^^^^
 
+`0.2.0`_ - 2019-05-06
+^^^^^^^^^^^^^^^^^^^^^
+
+Added
+"""""
+
+- The IBMQProvider supports connecting to the new version of the IBM Q API.
+  Please note support for this version is still experimental. (#78)
+- Added support for ``Circuits`` through the new API. (#79).
+
+Fixed
+"""""
+
+- Fixed incorrect parsing of some API hub URLs (#77).
+
+
 `0.1.1`_ - 2019-05-01
 ^^^^^^^^^^^^^^^^^^^^^
 
@@ -67,7 +83,8 @@ Removed
 
 
 
-.. _UNRELEASED: https://github.com/Qiskit/qiskit-ibmq-provider/compare/0.1.1...HEAD
+.. _UNRELEASED: https://github.com/Qiskit/qiskit-ibmq-provider/compare/0.2.0...HEAD
+.. _0.2.0: https://github.com/Qiskit/qiskit-ibmq-provider/compare/0.1.1...0.2.0
 .. _0.1.1: https://github.com/Qiskit/qiskit-ibmq-provider/compare/0.1...0.1.1
 .. _0.1: https://github.com/Qiskit/qiskit-ibmq-provider/compare/104d524...0.1
 
diff --git a/README.md b/README.md
index 083ca7c66..d2b0c738a 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,11 @@ Once the package is installed, you can access the provider from Qiskit.
 
 ### Configure your IBMQ credentials
 
+> **Note**: since `IBMQProvider` version `0.2.0`, the package supports
+> connecting to [the new IBM Q Experience], which includes a number of new
+> features. Please note that support is still experimental, and some
+> functionality might be subject to change or experience technical issues.
+
 1. Create an [IBM Q account] if you haven't already done so.
 
 2. Get an API token from the IBM Q website under
@@ -99,3 +104,4 @@ project at different levels. If you use Qiskit, please cite as per the included
 [many people]: https://github.com/Qiskit/qiskit-terra/graphs/contributors
 [BibTeX file]: https://github.com/Qiskit/qiskit/blob/master/Qiskit.bib
 [Apache License 2.0]: https://github.com/Qiskit/qiskit-ibmq-provider/blob/master/LICENSE.txt
+[the new IBM Q Experience]: https://quantum-computing.ibm.com/