Skip to content

Deel: Create a new adjustment

Deel adjustments.createContractAdjustment: arguments, response, policy and SDK examples.

← Adjustments operations · Get started

Operation deel.adjustments_createcontractadjustment

Provider route: POST /adjustments. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/deel with npm, or alter-sdk-deel with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { DeelIntegration } from "@alter-ai/deel";
async function execute(input: Parameters<DeelIntegration["adjustments"]["createContractAdjustment"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new DeelIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.adjustments.createContractAdjustment(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_deel import DeelIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = DeelIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.adjustments.create_contract_adjustment(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
bodyobjectOptional
body.dataModelRequired within parentExpand Create a new adjustment — request body — body data
Details of adjustment to create

Referenced models: Create a new adjustment — request body — body data

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$ModelRootExpand Create a new adjustment — 201 response body

Referenced models: Create a new adjustment — 201 response body

Create a new adjustment — request body — body data
FieldTypePresenceDescription and constraints
$objectRootDetails of adjustment to create
adjustment_category_idstringRequired within parentAdjustment category id.
Minimum length: 25
amountModelRequired within parentExpand Create a new adjustment — request body — body data amount
Amount of adjustment.
contract_idstringRequired within parentThe identifier of the contract associated with the adjustment
Minimum length: 5
countrystringOptionalCountry the expense was incurred in, which is not necessarily the contract country. Conditionally required: for adjustment categories configured to require a country, which is typically an expense category, and for Global Payroll contracts whenever the organization has the compliance check enabled, which applies to any category. Leave the field out entirely when it does not apply - sending it empty is rejected, because the pattern still applies to a value that is present.
Maximum length: 2
Minimum length: 2
Pattern: ^[A-Z]{2}$
cycle_referencestringOptionalCycle reference of adjustment.
date_of_adjustmentstring or nullOptionalShort date in format ISO-8601 (YYYY-MM-DD). For example: 2022-12-31.
Format: date
descriptionstringRequired within parentDescription of adjustment.
Maximum length: 255
Minimum length: 3
move_next_cycleboolean or nullOptionalIf an adjustments can belong to another payroll cycle.
odp_onlybooleanOptionalEOR contracts only. Restrict the adjustment to on-demand payroll: when true it is never attached to a regular payroll cycle, and it is automatically denied if it is still not part of an on-demand payroll 30 days after creation. Sending it for any other contract type is rejected, because on-demand payroll does not exist there. Editable only through this API, and it forces move_next_cycle to false.
submitter_profile_idinteger or nullOptionalThe identifier of the profile that submits the adjustment. Must be a profile authorized on the target contract. When omitted, the adjustment is attributed to the profile resolved from the API token.
Minimum: 1
titlestringRequired within parentTitle of adjustment.
Maximum length: 255
Minimum length: 3
vendorstringOptionalVendor of adjustment. Conditionally required: for adjustment categories configured to require a vendor, which is typically an expense category, and for Global Payroll contracts whenever the organization has the compliance check enabled, which applies to any category. Leave the field out entirely when it does not apply - sending it empty is rejected, because the length constraint still applies to a value that is present.
Minimum length: 3

Referenced models: Create a new adjustment — request body — body data amount

Create a new adjustment — 201 response body
FieldTypePresenceDescription and constraints
$objectRoot
dataModelRequired within parentExpand Create a new adjustment — 201 response body — data

Referenced models: Create a new adjustment — 201 response body — data

Create a new adjustment — request body — body data amount
FieldTypePresenceDescription and constraints
$JSONRootAmount of adjustment.
$ (oneOf 1)stringAlternativeMinimum length: 1
$ (oneOf 2)numberAlternativeFormat: double
Minimum: 1
Create a new adjustment — 201 response body — data
FieldTypePresenceDescription and constraints
$objectRoot
actual_end_cycle_datestringOptionalThe date of the actual end cycle date
actual_start_cycle_datestringOptionalThe date of the actual start cycle date
adjustment_category_idstringOptionalThe identifier of the adjustment category associated with the adjustment
amountstringOptionalThe amount of the adjustment
contract_idstringOptionalThe identifier of the contract associated with the adjustment
created_atstringOptionalThe date and time when the adjustment was created
Format: date-time
cycle_referenceJSONOptional
cycle_reference (anyOf 1)stringAlternativeThe reference to the cycle associated with the adjustment
cycle_reference (anyOf 2)nullAlternativeThe reference to the cycle associated with the adjustment
date_of_adjustmentstringOptionalThe date of the adjustment
Format: date-time
descriptionstringOptionalThe description of the adjustment
fileJSONOptionalAdjustment attachment
file (anyOf 1)ModelAlternativeExpand Create a new adjustment — 201 response body — data file Adjustment attachment
file (anyOf 2)nullAlternative
idstringOptionalThe unique identifier of the adjustment
move_next_cyclebooleanOptionalIf an adjustments can belong to another payroll cycle
odp_onlybooleanOptionalWhether the adjustment is restricted to on-demand payroll and never attached to a regular payroll cycle. Always false for contract types other than EOR
statusModelOptionalExpand Create a new adjustment — 201 response body — data status
The status of the adjustments
titlestringOptionalThe title of the adjustment
Maximum length: 255
Minimum length: 3
updated_atstringOptionalThe date and time when the adjustment was last updated
Format: date-time

Referenced models: Create a new adjustment — 201 response body — data file Adjustment attachment, Create a new adjustment — 201 response body — data status

Create a new adjustment — 201 response body — data file Adjustment attachment
FieldTypePresenceDescription and constraints
$objectRootAdjustment attachment
fileTypestringOptionalThe type of the file
idstringOptionalThe unique identifier of the file
namestringOptionalThe name of the file
Create a new adjustment — 201 response body — data status
FieldTypePresenceDescription and constraints
$JSONRootThe status of the adjustments
$ (anyOf 1)stringAlternativeAdjustment status (when contract type is GP)
Known values: OPEN, PENDING_APPROVAL, OVERWRITTEN, FAILED, SUCCESS, AI_CHECK_IN_PROGRESS
$ (anyOf 2)stringAlternativeAdjustment status (when contract type is EOR)
Known values: DRAFT, PENDING, ERRORS_FOUND, APPROVED, DENIED, DISBURSE_SCHEDULED, REIMBURSED, UNDER_REVIEW, PENDING_DEEL_REVIEW

SDK function policy ID: deel.adjustments_createcontractadjustment. Catalog operation: adjustments_createcontractadjustment. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["adjustments:write"]

Pinned headers: {"X-Version": "2026-01-01"}

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.