.

Signed-off-by: Simone Orru <[email protected]>

source/index.rst

@@ -1,5 +1,9 @@
 .. Astarte device SDKs documentation master file.
 
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
 ###################
 Astarte device SDKs
 ###################
@@ -177,6 +181,41 @@ UUID generation.
          device_id = UUID.uuid5(namespace_uuid, payload, :raw)
                |> Astarte.Core.Device.encode_device_id()
 
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
+==============================
+Automatic Registration (Agent)
+==============================
+
+You can refer to the
+`Astarte API for device registration <https://docs.astarte-platform.org/astarte/latest/api/index.html?urls.primaryName=Pairing%20API#/agent/registerDevice>`_
+for more details.
+
+.. tabs::
+
+   .. group-tab:: C
+
+      C (ESP32):
+
+      .. code-block:: C
+
+         astarte_pairing_config cfg =
+         {
+            .base_url = &base_astarte_url;
+            .jwt = &jwt_token;
+            .realm = &realm;
+            .hw_id = &device_id;
+            .credentials_secret = &credentials_secret;
+         };
+
+         astarte_err_t err = astarte_pairing_register_device(&astarte_pairing_config);
+
+   .. group-tab:: C++
+
+      C++ (Qt5): registration is done on device instantiation, see the next section.
+
+   .. group-tab:: Elixir
+
+      Elixir:
+
+      .. code-block:: Elixir
+
+         {:ok, %{body: %{"data" => %{"credentials_secret" => credentials_secret}}}} = Agent.register_device(client, device_id)