Crea una organización en MongoDB Cloud y la vincula a la organización de la cuenta de servicio o la clave API solicitante. Para utilizar este recurso, la cuenta de servicio solicitante o la clave de API debe tener el rol de propietario de la organización. La organización de la Cuenta de Servicio o la clave API que solicita debe ser una organización pagante. Para obtener más información, consulta Configurar una organización pagadora en la documentación de MongoDB Atlas. Opcionalmente, si se proporciona federationSettingsId, la nueva Organización estará vinculada a la federación. La cuenta de servicio o clave API de solicitud debe ser el propietario de la organización en la federación.
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
Organización que deseas crear.
-
Cuenta de servicio de organización que Atlas crea para esta organización. Si se omite, Atlas no crea una cuenta de servicio de la organización para esta organización. Si se especifica, este objeto requiere todos los parámetros del cuerpo. Ten en cuenta que no se pueden especificar claves API en la misma solicitud.
-
string única de 24 dígitos hexadecimales que identifica la federación a la que se vinculará la organización recién creada. Si se especifica, el propietario propuesto de la nueva organización debe tener el rol de propietario de organización en una organización asociada con la federación.
El formato debe coincidir con el siguiente patrón:
^([a-f0-9]{24})$. -
Etiqueta legible para humanos que identifica la organización.
El formato debe coincidir con el siguiente patrón:
^[\p{L}\p{N}\-_.(),:&@+']{1,64}$. -
Una única string de 24 dígitos hexadecimales que identifica al usuario de MongoDB Cloud al que deseas asignar el rol de Propietario de la organización. Este usuario debe ser miembro de la misma organización que la clave de API que realiza la llamada. Si proporcionas
federationSettingsId, este usuario debe tener el rol de propietario de la organización en una organización dentro de la federación especificada. Este parámetro sólo es necesario si se autentica con claves API programáticas.El formato debe coincidir con el siguiente patrón:
^([a-f0-9]{24})$. -
Cuenta de servicio de organización que Atlas crea para esta organización. Si se omite, Atlas no crea una cuenta de servicio de la organización para esta organización. Si se especifica, este objeto requiere todos los parámetros del cuerpo. Ten en cuenta que no se pueden especificar claves API en la misma solicitud.
-
Desactiva la creación automática de alertas. Si se establece como "verdadero", no se crearán alertas a nivel de organización automáticamente.
El valor por defecto es
false.
curl \
--request POST 'https://cloud.mongodb.com/api/atlas/v1.0/orgs' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"apiKey":{"desc":"string","roles":["ORG_OWNER"]},"federationSettingsId":"32b6e34b3d91647abb20e7b8","name":"string","orgOwnerId":"32b6e34b3d91647abb20e7b8","serviceAccount":{"description":"string","name":"string","roles":["ORG_MEMBER"],"secretExpiresAfterHours":8},"skipDefaultAlertsSettings":false}'{
"apiKey": {
"desc": "string",
"roles": [
"ORG_OWNER"
]
},
"federationSettingsId": "32b6e34b3d91647abb20e7b8",
"name": "string",
"orgOwnerId": "32b6e34b3d91647abb20e7b8",
"serviceAccount": {
"description": "string",
"name": "string",
"roles": [
"ORG_MEMBER"
],
"secretExpiresAfterHours": 8
},
"skipDefaultAlertsSettings": false
}{
"apiKey": {
"desc": "string",
"id": "32b6e34b3d91647abb20e7b8",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"privateKey": "55c3bbb6-b4bb-0be1-e66d20841f3e",
"publicKey": "zmmrboas",
"roles": [
{
"groupId": "32b6e34b3d91647abb20e7b8",
"orgId": "32b6e34b3d91647abb20e7b8",
"roleName": "string"
}
]
},
"federationSettingsId": "32b6e34b3d91647abb20e7b8",
"orgOwnerId": "32b6e34b3d91647abb20e7b8",
"organization": {
"id": "32b6e34b3d91647abb20e7b8",
"isDeleted": true,
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"name": "string",
"skipDefaultAlertsSettings": false
},
"serviceAccount": {
"clientId": "mdb_sa_id_1234567890abcdef12345678",
"createdAt": "2026-05-04T09:42:00Z",
"description": "string",
"name": "string",
"roles": [
"ORG_MEMBER"
],
"secrets": [
{
"createdAt": "2026-05-04T09:42:00Z",
"expiresAt": "2026-05-04T09:42:00Z",
"id": "32b6e34b3d91647abb20e7b8",
"lastUsedAt": "2026-05-04T09:42:00Z",
"maskedSecretValue": "mdb_sa_sk_...",
"secret": "mdb_sa_sk_..."
}
]
},
"skipDefaultAlertsSettings": false
}{
"error": 400,
"detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
"reason": "Bad Request",
"errorCode": "VALIDATION_ERROR"
}{
"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": 409,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot delete organization link while there is active migration in following project ids: 60c4fd418ebe251047c50554",
"reason": "Conflict",
"errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK"
}{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}