From 1b21400195694e36e22ded4587a3efff319fc65a Mon Sep 17 00:00:00 2001
From: kevin-loehfelm <37027455+kevin-loehfelm@users.noreply.github.com>
Date: Wed, 1 May 2024 17:19:26 -0400
Subject: [PATCH] =?UTF-8?q?added=20documentation=20for=20mongodb=20atlas?=
 =?UTF-8?q?=20database=20secrets=20engine=20eventua=E2=80=A6=20(#24152)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* added documentation for mongodb atlas database secrets engine eventual consistency
---
 changelog/24152.txt                                    |  3 +++
 .../content/docs/secrets/databases/mongodbatlas.mdx    | 10 ++++++++++
 2 files changed, 13 insertions(+)
 create mode 100644 changelog/24152.txt

diff --git a/changelog/24152.txt b/changelog/24152.txt
new file mode 100644
index 000000000000..80ef3015377b
--- /dev/null
+++ b/changelog/24152.txt
@@ -0,0 +1,3 @@
+```release-note:improvement
+website/docs: Add note about eventual consietency with the MongoDB Atlas database secrets engine
+```
diff --git a/website/content/docs/secrets/databases/mongodbatlas.mdx b/website/content/docs/secrets/databases/mongodbatlas.mdx
index 29b5dac99e85..0e8d358e813a 100644
--- a/website/content/docs/secrets/databases/mongodbatlas.mdx
+++ b/website/content/docs/secrets/databases/mongodbatlas.mdx
@@ -84,6 +84,16 @@ the proper permissions, it can generate credentials.
         username           v-my-password-role-DKbQEg6uRn
     ```
 
+    Each invocation of the command generates a new credential.
+
+    MongoDB Atlas database credentials eventually become consistent when the
+    [MongoDB Atlas Admin API](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/)
+    coordinates with hosted clusters in your Atlas project. You cannot use the
+    credentials successfully until the consistency process completes.
+
+    If you plan to use MongoDB Atlas credentials in a pipeline, you may need to add
+    a time delay or secondary process to account for the time required to establish consistency.
+
 #### Client certificate credentials
 
 1.  Configure a role that maps a name in Vault to a MongoDB Atlas command that executes and