Crea una cuenta de usuario de MongoDB nube. Una cuenta de usuario de MongoDB Cloud otorga acceso solamente a la aplicación de MongoDB Cloud. Para conceder acceso a la base de datos, crea un usuario de base de datos. MongoDB Nube envía un correo electrónico a los usuarios que especificas, invitándolos a unirse al Proyecto. Los usuarios invitados no tienen acceso al proyecto hasta que aceptan la invitación. Las invitaciones expiran después de 30 días.
MongoDB Cloud limita la membresía de usuario de MongoDB nube a un máximo de 250 usuarios de MongoDB nube por equipo. MongoDB nube limita la membresía de usuario de MongoDB nube a 500 usuarios de MongoDB nube por Proyecto y 500 usuarios de MongoDB nube por organización, lo que incluye la membresía combinada de todos los Proyectos en la organización. MongoDB nube genera un error si una operación supera estos límites. Por ejemplo, si tienes una organización con cinco Proyectos, y cada Proyecto tiene 100 usuarios de MongoDB nube, y cada usuario de MongoDB nube pertenece solo a un Proyecto, no puedes agregar ningún usuario de MongoDB nube a esta organización sin antes remover los usuarios existentes de MongoDB nube de la organización.
Para utilizar este recurso, la cuenta de servicio solicitante o la clave API puede tener cualquier rol.
Parámetros de query
-
Bandera que indica si la aplicación envuelve la respuesta en un objeto JSON
envelope. Algunos clientes de la API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para remediar esto, establece envelope=true en la query. Los endpoints que devuelven una lista de resultados utilizan el objeto de resultados como un sobre. La aplicación agrega el parámetro de estado al cuerpo de la respuesta.El valor por defecto es
false. -
Bandera que indica si el cuerpo de la respuesta debe estar en el formato prettyprint.
El valor por defecto es
false.Impresión bonita
Cuerpo
Requerido
Cuenta de usuario de MongoDB Cloud para crear.
-
Dos caracteres que identifican la ubicación geográfica del usuario de MongoDB Cloud. Este parámetro utiliza el formato de código ISO 3166-1a2.
El formato debe coincidir con el siguiente patrón:
^([A-Z]{2})$. -
Nombre o nombre de pila que pertenece al usuario de MongoDB Cloud.
-
Apellido familiar, nombre de familia o apellido que pertenece al usuario de MongoDB Cloud.
-
Número de teléfono móvil que pertenece al usuario de MongoDB Cloud.
El formato debe coincidir con el siguiente patrón:
(?:(?:\\+?1\\s*(?:[.-]\\s*)?)?(?:(\\s*([2-9]1[02-9]|[2-9][02-8]1|[2-9][02-8][02-9])\\s*)|([2-9]1[02-9]|[2-9][02-8]1|[2-9][02-8][02-9]))\\s*(?:[.-]\\s*)?)([2-9]1[02-9]|[2-9][02-9]1|[2-9][02-9]{2})\\s*(?:[.-]\\s*)?([0-9]{4})$. -
Contraseña aplicada al nombre de usuario para iniciar sesión en MongoDB nube. MongoDB Cloud no devuelve este parámetro excepto en respuesta a la creación de un nuevo usuario de MongoDB Cloud. Solo el usuario de MongoDB Cloud puede actualizar su contraseña después de que se haya establecido desde la consola de MongoDB Cloud.
La longitud mínima es
8. -
Lista de objetos que muestran los roles del usuario de MongoDB Cloud y la organización o proyecto correspondiente al que se aplica ese rol. Un rol puede aplicarse a una organización o un proyecto, pero no a ambos.
-
Dirección de correo electrónico que representa el nombre de usuario del usuario de MongoDB Cloud.
curl \
--request POST 'https://cloud.mongodb.com/api/atlas/v1.0/users' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"country":"string","firstName":"string","lastName":"string","mobileNumber":"string","password":"string","roles":[{"groupId":"32b6e34b3d91647abb20e7b8","orgId":"32b6e34b3d91647abb20e7b8","roleName":"string"}],"username":"hello@example.com"}'{
"country": "string",
"firstName": "string",
"lastName": "string",
"mobileNumber": "string",
"password": "string",
"roles": [
{
"groupId": "32b6e34b3d91647abb20e7b8",
"orgId": "32b6e34b3d91647abb20e7b8",
"roleName": "string"
}
],
"username": "hello@example.com"
}{
"country": "string",
"createdAt": "2026-05-04T09:42:00Z",
"emailAddress": "hello@example.com",
"firstName": "string",
"id": "32b6e34b3d91647abb20e7b8",
"lastAuth": "2026-05-04T09:42:00Z",
"lastName": "string",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"mobileNumber": "string",
"password": "string",
"roles": [
{
"groupId": "32b6e34b3d91647abb20e7b8",
"orgId": "32b6e34b3d91647abb20e7b8",
"roleName": "string"
}
],
"teamIds": [
"32b6e34b3d91647abb20e7b8"
],
"username": "hello@example.com"
}{
"error": 401,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Unauthorized",
"errorCode": "NOT_ORG_GROUP_CREATOR"
}{
"error": 403,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Forbidden",
"errorCode": "CANNOT_CHANGE_GROUP_NAME"
}{
"error": 404,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"reason": "Not Found",
"errorCode": "RESOURCE_NOT_FOUND"
}{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}