# Submit a human resource

**Requires scope:** `setu`.
The main element of the message, this container holds all elements needed
to define a human resource (the person being staffed) in the SETU
standard. SETU is the Dutch staffing industry's XML interchange standard.

Endpoint: POST /api/setu/1.4.1/humanResource
Security: apiKey

## Request fields (application/xml):

  - `HumanResource` (object)

  - `HumanResource.HumanResourceId` (object, required)
    Container for the unique identifier of the human resource.

  - `HumanResource.HumanResourceId.idOwner` (string, required)
    The organization that issues the identifier. This organization is also
responsible for the uniqueness of the identifier within its own context.
    Enum: "StaffingCompany", "StaffingCustomer"

  - `HumanResource.HumanResourceId.IdValue` (string, required)
    The unique identifier of the human resource.

  - `HumanResource.ResourceInformation` (object, required)
    Information about the human resource.

  - `HumanResource.ResourceInformation.PersonName` (object, required)
    The name of the human resource.

  - `HumanResource.ResourceInformation.PersonName.FormattedName` (string, required)
    A fully formatted name as an XML string.
    Example: Piet van der Berg

  - `HumanResource.ResourceInformation.PersonName.GivenName` (string, required)
    The given or chosen name. The element may occur more than once,
one element for each given name.
    Example: Arend

  - `HumanResource.ResourceInformation.PersonName.PreferredGivenName` (string, required)
    The preferred given name.
    Example: Piet

  - `HumanResource.ResourceInformation.PersonName.FamilyName` (object, required)
    The family name. There can be multiple family names, but there
can be only one primary family name.

  - `HumanResource.ResourceInformation.PersonName.FamilyName.primary` (string)
    Exactly one family name is required to have `primary` set to `TRUE`.
Indicates whether this is the primary family name or any maiden/birth
name. Must be `TRUE` for the primary family name and `FALSE` for any
additional maiden/birth name.
    Enum: "TRUE", "FALSE"

  - `HumanResource.ResourceInformation.PersonName.FamilyName.prefix` (string)
    Prefix of the family name.
    Example: van der

  - `HumanResource.ResourceInformation.EntityContactInfo` (object, required)
    Contact information of the human resource.

  - `HumanResource.ResourceInformation.EntityContactInfo.ContactMethod` (object, required)
    Container for information on contacting the human resource.

  - `HumanResource.ResourceInformation.EntityContactInfo.ContactMethod.Mobile` (object)
    Container for specifying the mobile number.

  - `HumanResource.ResourceInformation.EntityContactInfo.ContactMethod.Mobile.FormattedNumber` (string, required)
    A fully formatted mobile number as an XML string.

  - `HumanResource.ResourceInformation.EntityContactInfo.ContactMethod.Telephone` (object)
    Container for specifying the telephone number.

  - `HumanResource.ResourceInformation.EntityContactInfo.ContactMethod.Telephone.FormattedNumber` (string, required)
    A fully formatted telephone number as an XML string.

  - `HumanResource.ResourceInformation.EntityContactInfo.ContactMethod.InternetEmailAddress` (string, required)
    Email address of the human resource. Will be used as the username
for login.
    Example: john.doe@example.com

  - `HumanResource.ResourceInformation.PostalAddress` (object)
    The home address of the human resource.

  - `HumanResource.ResourceInformation.PostalAddress.PostalCode` (string)
    The postal code.

  - `HumanResource.ResourceInformation.PostalAddress.Municipality` (string)
    The city.

  - `HumanResource.ResourceInformation.PostalAddress.DeliveryAddress` (object)
    Container for specifying the delivery address.

  - `HumanResource.ResourceInformation.PostalAddress.DeliveryAddress.StreetName` (string)
    The street name.

  - `HumanResource.ResourceInformation.PostalAddress.DeliveryAddress.BuildingNumber` (string)
    The number of the building.

  - `HumanResource.ResourceInformation.PostalAddress.DeliveryAddress.Unit` (string)
    The number addition.

  - `HumanResource.HumanResourceAdditionalNL` (object)
    Additional schema for SETU-specific elements.

  - `HumanResource.HumanResourceAdditionalNL.BirthDate` (string)
    The birth date of the human resource in `YYYY-MM-DD` (ISO 8601).

  - `HumanResource.HumanResourceAdditionalNL.Sex` (string)
    The gender of the human resource.
    Enum: "female", "male", "unknown"

  - `HumanResource.HumanResourceAdditionalNL.CustomerReportingRequirements` (object)
    Container for (reporting) related information concerning the offer.

  - `HumanResource.HumanResourceAdditionalNL.CustomerReportingRequirements.CostCenterName` (string)
    The name of the cost center of the staffing customer for the
staffing position.

## Response 400 fields (application/xml):

  - `errors` (array)

  - `errors.message` (string)

  - `errors.code` (null | string)

  - `errors.context` (object)

  - `errors.context.field` (null | string)
    The field related to the encountered error.

## Response 401 fields (application/xml):

  - `message` (string)
    Invalid authentication token
    Example: Unauthorized

## Response 403 fields (application/xml):

  - `message` (string)
    Invalid authentication token scope
    Example: Forbidden