Skip to content

Deel: Create a person without a contract

Deel people.createPersonWithoutContract: arguments, response, policy and SDK examples.

← People operations · Get started

Operation deel.people_createpersonwithoutcontract

Provider route: POST /pwac. 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["people"]["createPersonWithoutContract"]>[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.people.createPersonWithoutContract(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.people.create_person_without_contract(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
bodyobjectOptional
body.dataModelRequired within parentExpand Create a person without a contract — request body — body data

Referenced models: Create a person without a contract — 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 person without a contract — 201 response body

Referenced models: Create a person without a contract — 201 response body

Create a person without a contract — 201 response body
FieldTypePresenceDescription and constraints
$objectRoot
dataModelRequired within parentExpand Create a person without a contract — 201 response body — data

Referenced models: Create a person without a contract — 201 response body — data

Create a person without a contract — request body — body data
FieldTypePresenceDescription and constraints
$objectRoot
clientModelRequired within parentExpand Create a person without a contract — request body — body data client
invitationModelOptionalExpand Create a person without a contract — request body — body data invitation
Optional invitation configuration for the new hire. Defaults to 'disable' if not provided.
personModelRequired within parentExpand Create a person without a contract — request body — body data person
The person that is being hired

Referenced models: Create a person without a contract — request body — body data client, Create a person without a contract — request body — body data invitation, Create a person without a contract — request body — body data person

Create a person without a contract — 201 response body — data
FieldTypePresenceDescription and constraints
$objectRoot
idstringRequired within parentThe id of the person
Format: uuid
personModelRequired within parentExpand Create a person without a contract — 201 response body — data person
The person that is being hired

Referenced models: Create a person without a contract — 201 response body — data person

Create a person without a contract — request body — body data client
FieldTypePresenceDescription and constraints
$objectRoot
departmentModelOptionalExpand Create a person without a contract — request body — body data client department
legal_entityModelRequired within parentExpand Create a person without a contract — request body — body data client legal entity
teamModelRequired within parentExpand Create a person without a contract — request body — body data client team

Referenced models: Create a person without a contract — request body — body data client department, Create a person without a contract — request body — body data client legal entity, Create a person without a contract — request body — body data client team

Create a person without a contract — request body — body data invitation
FieldTypePresenceDescription and constraints
$objectRootOptional invitation configuration for the new hire. Defaults to 'disable' if not provided.
actionstringOptionalControls whether to send an invitation email.
One of: DISABLE, IMMEDIATE
Create a person without a contract — request body — body data person
FieldTypePresenceDescription and constraints
$objectRootThe person that is being hired
addressModelOptionalExpand Create a person without a contract — request body — body data person address
The home address of the person being hired
countrystringOptionalThe country of the person being hired
Maximum length: 2
Minimum length: 2
emailstringRequired within parentThe personal email of the person being hired
Format: email
Maximum length: 255
Minimum length: 3
end_datestringOptionalThe end date of the person being hired
Format: date
external_idstringOptionalAn external identifier for the person being hired
Maximum length: 100
first_namestringRequired within parentThe first name of the person being hired
Maximum length: 100
Minimum length: 1
job_titlestringOptionalThe job title of the person being hired
Maximum length: 255
last_namestringRequired within parentThe last name of the person being hired
Maximum length: 100
Minimum length: 1
nationalitystringOptionalThe nationality of the person being hired
Maximum length: 2
Minimum length: 2
preferred_first_namestringOptionalThe preferred first name of the person being hired
Maximum length: 100
Minimum length: 1
preferred_last_namestringOptionalThe preferred last name of the person being hired
Maximum length: 100
Minimum length: 1
senioritystringOptionalThe seniority of the person being hired
Maximum length: 255
start_datestringRequired within parentThe start date of the person being hired
Format: date
statestringOptionalThe state of the person being hired
Maximum length: 50
Minimum length: 1
work_emailstringOptionalThe work email of the person being hired
Format: email
Maximum length: 255
Minimum length: 3

Referenced models: Create a person without a contract — request body — body data person address

Create a person without a contract — 201 response body — data person
FieldTypePresenceDescription and constraints
$objectRootThe person that is being hired
countrystringOptionalThe country of the person being hired
Maximum length: 2
Minimum length: 2
emailstringRequired within parentThe personal email of the person being hired
Format: email
end_dateJSONOptional
end_date (anyOf 1)stringAlternativeThe end date of the person being hired
Format: date
end_date (anyOf 2)nullAlternativeThe end date of the person being hired
Format: date
external_idJSONOptional
external_id (anyOf 1)stringAlternativeAn external identifier for the person being hired
external_id (anyOf 2)nullAlternativeAn external identifier for the person being hired
first_namestringRequired within parentThe first name of the person being hired
job_titlestringOptionalThe job title of the person being hired
last_namestringRequired within parentThe last name of the person being hired
nationalitystringOptionalThe nationality of the person being hired
Maximum length: 2
Minimum length: 2
senioritystringOptionalThe seniority of the person being hired
start_datestringRequired within parentThe start date of the person being hired
Format: date
statestringOptionalThe state of the person being hired
Maximum length: 50
Minimum length: 1
work_emailstringOptionalThe work email of the person being hired
Format: email
worker_idJSONOptional
worker_id (anyOf 1)numberAlternativeThe worker ID of the person being hired
Format: double
worker_id (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
Create a person without a contract — request body — body data client department
FieldTypePresenceDescription and constraints
$objectRoot
idstringRequired within parentThe department that the person is part of
Format: uuid
Create a person without a contract — request body — body data client legal entity
FieldTypePresenceDescription and constraints
$objectRoot
idstringRequired within parentThe legal entity that the person is part of
Format: uuid
Create a person without a contract — request body — body data client team
FieldTypePresenceDescription and constraints
$objectRoot
direct_manager_idstringOptionalThe direct manager of the person
Format: uuid
direct_reports_idsarrayOptionalThe direct reports of the person
direct_reports_ids[]stringEach itemFormat: uuid
idstringRequired within parentThe team that the person is part of
Format: uuid
Create a person without a contract — request body — body data person address
FieldTypePresenceDescription and constraints
$objectRootThe home address of the person being hired
citystringOptionalThe city of the home address
countrystringRequired within parentThe country of the home address as an ISO 3166-1 alpha-2 code
Maximum length: 2
Minimum length: 2
line_twostring or nullOptionalThe second line of the home address
statestring or nullOptionalThe state or province of the home address
streetstringOptionalThe street and number of the home address
zipstringOptionalThe postal code of the home address

SDK function policy ID: deel.people_createpersonwithoutcontract. Catalog operation: people_createpersonwithoutcontract. 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: ["people: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.