---
title: "Create a new Resource Account in the organization."
method: POST
path: "/orgs/{orgId}/resources/accounts"
tags: ["public", "ResourceAccount"]
---

# Create a new Resource Account in the organization.

`POST /orgs/{orgId}/resources/accounts`

## Path parameters

- `orgId` string, required

## Query parameters

- `dry_run` boolean
- `check_credential` boolean

## Request body

- CreateResourceAccountRequestRequest — CreateResourceAccountRequest describes the request to create a new security account.
  - `credentials` object, required — Credentials associated with the account.
  - `id` string, required — Unique identifier for the account (in scope of the organization it belongs to).
  - `name` string, required — Display name.
  - `type` string, required — The type of the account

## Response `200`

The newly created Resources Account details.

- ResourceAccountResponse — ResourceAccount represents the account being used to access a resource. Resource Accounts hold credentials that are required to provision and manage resources.
  - `created_at` string, date-time, required — The timestamp of when the account was created.
  - `created_by` string, required — The ID of the user who created the account.
  - `id` string, required — Unique identifier for the account (in scope of the organization it belongs to).
  - `is_used` boolean, required — Indicates if this account is being used (referenced) by any resource definition or active resource.
  - `name` string, required — Display name.
  - `type` string, required — The type of the account

## Other responses

- `204` — The Resource Account details are valid but were not persisted because dry-run is enabled.
- `400` — One or more request parameters is missing or invalid.
- `401` — Authentication token is missing or invalid.
- `409` — A Resources Account already exists.
- `500` — Internal application error.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)