# Create Person

Creates a profile for an individual within the organization, defining capacity, roles, and billable status for resourcing and forecasting.

Endpoint: POST /v1/people
Version: v1
Security: ApiKey

## Request fields (application/json-patch+json):

  - `given_name` (string,null)
    The first name or given name of the Person.

  - `family_name` (string,null)
    The last name or family name of the Person.

  - `email_address` (string, required)
    The email address associated with the Person.

  - `capacity` (number,null)
    The capacity of this Person if they are using a custom capacity instead of their Role's capacity.Note: This value can be cleared out by sending null in the request body.

  - `role_id` (string,null)
    Id of the Role to be used as the primary (default) Role for this person. If null, the unassigned role will be applied instead.

  - `billable_utilization_target` (number,null)
    The billable utilization target of this Person if they are using a custom target utilization instead of their Role's target utilization. Note: This value can be cleared out by sending null in the request body.

  - `billable` (boolean)
    Denotes whether this Person's time worked is billable. Defaults to true for new records.

  - `start_date` (string,null)
    The earliest date this Person is available for resourcing on a Project. The Person's capacity prior to this date is 0%.

  - `end_date` (string,null)
    If this Person will have or has had their employment or contract terminated, this is the last date they are available for resourcing on a project. They will automatically be archived after this date has passed, and their capacity will drop to 0%. This value can be cleared out by sending null in the request body.

  - `worker_type` (object)
    Denotes whether this Person is a full time employee, contractor, etc. Defaults to full_time for new records.

  - `tags` (array,null)
    A list of tags used to categorize the Person for filtering, reporting, or custom grouping.

  - `image_url` (string,null)
    A publicly-accessible URL to an avatar for this Person.

## Response 201 fields (application/json):

  - `id` (string)
    The unique identifier of the Person in Parallax.

  - `given_name` (string,null)
    The first name or given name of the Person.

  - `family_name` (string,null)
    The last name or family name of the Person.

  - `email_address` (string,null)
    The email address associated with the Person.

  - `capacity` (number,null)
    The capacity of this Person if they are using a custom capacity instead of their Role's capacity.Note: This value can be cleared out by sending null in the request body.

  - `role_id` (string)
    Id of the Role to be used as the primary (default) Role for this person.

  - `billable_utilization_target` (number,null)
    The billable utilization target of this Person if they are using a custom target utilization instead of their Role's target utilization. Note: This value can be cleared out by sending null in the request body.

  - `billable` (boolean)
    Indicates whether the Person's work is considered billable for client projects.

  - `start_date` (string,null)
    The earliest date this Person is available for resourcing on a Project. The Person's capacity prior to this date is 0%.

  - `end_date` (string,null)
    If this Person will have or has had their employment or contract terminated, this is the last date they are available for resourcing on a project. They will automatically be archived after this date has passed, and their capacity will drop to 0%. This value can be cleared out by sending null in the request body.

  - `worker_type` (object)
    Specifies the worker classification for the Person, such as Employee or Contractor.

  - `tags` (array)
    A list of tags used to categorize the Person for filtering, reporting, or custom grouping.

  - `created_date` (string)
    The date and time when the Person record was created in Parallax.

  - `modified_date` (string)
    The date and time when the Person record was last modified in Parallax.

  - `image_url` (string,null)
    The URL of the profile image associated with the Person.

  - `archived` (boolean)
    Indicates whether the Person is archived and no longer active for project assignment or planning.

  - `current_cost_rate` (object)
    The current effective cost rate for the person. This will return the current overridden cost rate of the person, and will fall back to the current cost rate of their assigned role if there is no override.

  - `current_cost_rate.currency_code` (string)
    The currency code of the monetary object.

  - `current_cost_rate.amount` (number)
    The amount of the monetary object.

## Response 400 fields (application/json):

  - `type` (string)
    RFC reference for the error type

  - `title` (string)
    Human-readable summary of the error

  - `status` (integer)
    HTTP status code

  - `errors` (array)
    Detailed error messages for each validation failure

  - `trace_id` (string)
    Trace identifier for debugging