---
title: "Create CounterAdjustment"
method: POST
path: "/organizations/{orgId}/counteradjustments"
tags: ["CounterAdjustments"]
---

# Create CounterAdjustment

`POST /organizations/{orgId}/counteradjustments`

Create a new CounterAdjustment for an Account using a Counter.

**Notes:**
* Use the new absolute value for the Counter for the selected date - if it was 15 and has increased to 20, enter 20; if it was 15 and has decreased to 10, enter 10. *Do not enter* the plus or minus value relative to the previous Counter value on the Account.
* CounterAdjustments on Accounts are supported down to a *specific day* of granularity - you cannot create more than one CounterAdjustment for any given day using the same Counter and you'll receive an error if you try to do this.

## Path parameters

- `orgId` string, required

## Request body

- CounterAdjustmentRequest
  - `version` integer — The version number of the entity: - **Create entity:** Not valid for initial insertion of new entity - *do not use for Create*. On initial Create, version is set at 1 and listed in the response. - **Update Entity:** On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response.
  - `counterId` string, required — The ID of the Counter used for the CounterAdjustment on the Account.
  - `accountId` string, required — The Account ID the CounterAdjustment is created for.
  - `date` string, required — The date the CounterAdjustment is created for the Account *(in ISO-8601 date format)*. **Note:** CounterAdjustments on Accounts are supported down to a *specific day* of granularity - you cannot create more than one CounterAdjustment for any given day using the same Counter and you'll receive an error if you try to do this.
  - `value` integer, required — Integer Value of the Counter used for the CounterAdjustment. **Note:** Use the new absolute value for the Counter for the selected date - if it was 15 and has increased to 20, enter 20; if it was 15 and has decreased to 10, enter 10. *Do not enter* the plus or minus value relative to the previous Counter value on the Account.
  - `purchaseOrderNumber` string — Purchase Order Number for the Counter Adjustment. *(Optional)*

## Response `200`

Returns the created CounterAdjustment

- CounterAdjustmentResponse
  - `id` string, required — The UUID of the entity.
  - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.
  - `dtCreated` string, date-time — The DateTime when this item was created *(in ISO-8601 format)*.
  - `dtLastModified` string, date-time — The DateTime when this item was last modified *(in ISO-8601 format)*.
  - `createdBy` string — The ID of the user who created this item.
  - `lastModifiedBy` string — The ID of the user who last modified this item.
  - `counterId` string — The ID of the Counter that was used to make the CounterAdjustment on the Account.
  - `accountId` string — The Account ID the CounterAdjustment was created for.
  - `date` string, date — The date the CounterAdjustment was created for the Account *(in ISO-8601 date format)*.
  - `value` integer — Integer Value of the Counter that was used to make the CounterAdjustment.
  - `purchaseOrderNumber` string — Purchase Order Number for the Counter Adjustment. *(Optional)*

## Other responses

- `4XX` — Error message
- `5XX` — Error message

---

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