---
title: "Create status"
method: POST
path: "/accounts/v4/statuses"
tags: ["Statuses and reasons"]
---

# Create status

`POST /accounts/v4/statuses`

Create an account status on the platform.

When a new account status is created, its initial `state` (see response) is `ACTIVE`. 

This endpoint generates an [Account status created](https://developers.pismo.io/events/docs/account-status-creation-1) event.

Refer to the [Account status](https://developers.pismo.io/pismo-docs/docs/accounts-overview#account-status) guide section for more information.

## Request body

- StatusCreate — Account status object
  - `name` string, required — Account status name. Pre-defined account statuses include `DEBIT_ONLY`, `NORMAL`, `BLOCKED` and `CANCELLED`. You can create your own account statuses with the [Create status](https://developers.pismo.io/pismo-docs/reference/v4-post-account-status) endpoint.
  - `allowed_operations` OperationsBlocksOperation[], required — List of operations allowed to bypass the block enforcement logic.<br> - `EARMARK_RELEASE`: Release an earmark even when an operation block is active. - `EARMARK_UPDATE`: Update an earmark (set amount, increase, or decrease) while the account is blocked by an operation block. - `PAYMENT_DEBIT`: Execute a debit transaction while the account is blocked by an operation block. - `PAYMENT_CREDIT`: Execute a credit transaction while the account is blocked by an operation block. - `PAYMENT_CONFIRM`: Confirm a value transaction while the account is blocked by an operation block. - `PAYMENT_CANCEL`: Cancel an existing transaction while the account is blocked by an operation block. - `ACCOUNT_STATUS_UPDATE`: Change the account status and the associated status reason. - `CHECK_POST`: Post a check while the account is blocked by an operation block. - `CHECK_RELEASE`: Release an uncleared check or operation while the account is blocked by an operation block. - `CHECK_CANCEL`: Cancel an existing check while the account is blocked by an operation block. - `RESTRICTED_FUNDS_CREATE`: Hold a specified amount by transferring it from the available balance to restricted funds. - `RESTRICTED_FUNDS_RELEASE`: Release restricted funds from hold. This transfers funds from restricted funds back to available balance.
  - `description` string — Account status description
  - `is_final` boolean — Is this a final status? An account with a final status cannot have its status updated. Defaults to `false`. **Note:** Even if a status is final, it can still be [rolled back](https://developers.pismo.io/pismo-docs/reference/patch-v2-accounts-accountid-status-rollback).

## Response `201`

Created

- StatusResponse — Object response for account status
  - `status_id` integer — Account status ID
  - `name` string — Account status name. Pre-defined account statuses include `DEBIT_ONLY`, `NORMAL`, `BLOCKED` and `CANCELLED`. You can create your own account statuses with the [Create status](https://developers.pismo.io/pismo-docs/reference/v4-post-account-status) endpoint.
  - `description` string — Account status description
  - `state` 'ACTIVE' | 'INACTIVE' — Status state
  - `is_final` boolean — Is this a final status? An account with a final status cannot have its status updated. Defaults to `false`. **Note:** Even if a status is final, it can still be [rolled back](https://developers.pismo.io/pismo-docs/reference/patch-v2-accounts-accountid-status-rollback).
  - `allowed_operations` OperationsBlocksOperation[] — List of operations allowed to bypass the block enforcement logic.<br> - `EARMARK_RELEASE`: Release an earmark even when an operation block is active. - `EARMARK_UPDATE`: Update an earmark (set amount, increase, or decrease) while the account is blocked by an operation block. - `PAYMENT_DEBIT`: Execute a debit transaction while the account is blocked by an operation block. - `PAYMENT_CREDIT`: Execute a credit transaction while the account is blocked by an operation block. - `PAYMENT_CONFIRM`: Confirm a value transaction while the account is blocked by an operation block. - `PAYMENT_CANCEL`: Cancel an existing transaction while the account is blocked by an operation block. - `ACCOUNT_STATUS_UPDATE`: Change the account status and the associated status reason. - `CHECK_POST`: Post a check while the account is blocked by an operation block. - `CHECK_RELEASE`: Release an uncleared check or operation while the account is blocked by an operation block. - `CHECK_CANCEL`: Cancel an existing check while the account is blocked by an operation block. - `RESTRICTED_FUNDS_CREATE`: Hold a specified amount by transferring it from the available balance to restricted funds. - `RESTRICTED_FUNDS_RELEASE`: Release restricted funds from hold. This transfers funds from restricted funds back to available balance.

## Other responses

- `400` — Bad request
- `409` — Conflict
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/versions/935b62e16de4/schema)