personCreate Mutation

Creates a new person.

Input Argument

personCreate accepts a single input argument, an input type, which contains the values it uses.

The fields inside input are:

authenticationID (String)

Uniquely identify the user for Single Sign-On

autoTranslation (Boolean)

Whether the person should be offered translations for texts that are written in languages other than the ones selected in the Language (language) and the Do not translate (do_not_translate_languages) arguments. Such texts are translated automatically into the language selected in the Language (language) argument.

clientMutationId (String)

A unique identifier for the client performing the mutation.

configurationItemIds ([ID!])

Configuration items this person is related to as a user.

costPerHour (MonetaryAmount)

The person's estimated total cost per work hour for the service provider organization. The value in this argument should include the costs of the person's salary (or rate in case of a long-term contractor), office space, service subscriptions, training, etc.

costPerHourCurrency (Currency)

The currency of the cost per hour value attributed to this person.

customFields ([CustomFieldInput!])

Values for custom fields to be used by the UI Extension that is linked to the record.

customFieldsAttachments ([AttachmentInput!])

The attachments used in the custom fields' values.

disabled (Boolean)

true when the person may no longer be related to other records.

doNotTranslateLanguages ([String!])

The languages that should not be translated automatically for the person. Translations will not be offered to the person for texts in any of these languages. Supported language codes are: en, nl, de, fr, es, pt, it, da, fi, sv, pl, cs, tr, ru, ar, id, fa, no, zh, ja, ko, he, hi, ms.

employeeID (String)

The unique identifier for a person typically based on order of hire or association with an organization.

excludeTeamNotifications (Boolean)

Whether team notifications should be excluded from all notifications.

information (String)

Any additional information about the person that might prove useful.

jobTitle (String)

The person's job title.

language (String)

The language preference of the person.

location (String)

The name or number of the room, cubicle or area where the person has his/her primary work space.

managerId (ID)

The manager or supervisor to whom the person reports.

name (String!)

The name of the person.

newAccountPermissions ([PermissionInput!])

Permissions for specific accounts of this person to add or update. Permissions for other accounts will not be altered.

newAddresses ([AddressInput!])

New or updated addresses of this person.

newContacts ([ContactInput!])

New or updated contacts of this person.

oauthPersonEnablement (Boolean)

An enabled OAuth person is mentionable and visible in suggest fields, just like a real person.

organizationId (ID)

The organization for which the person works as an employee or long-term contractor.

permissions ([PermissionInput!])

Permissions of this person. These will overwrite all existing permissions of this person.

pictureUri (String)

The hyperlink to the image file for the record.

primaryEmail (String!)

The email address to which email notifications are to be sent. This email address acts as the unique identifier for the person within the 4me account. This primary email address also acts as the person's login name if he/she is a user of the 4me service.

sendEmailNotifications (PersonSendEmailNotifications)

Indicates when to send email notifications to the person.

showNotificationPopup (PersonShowNotificationPopup)

Indicates when to show a notification popup to the person.

siteId (ID)

Where the person is stationed.

skillPoolIds ([ID!])

Skill pools this person belongs to.

source (String)

An identifier for the client application submitting the resource or the name of an external system.

sourceID (String)

The unique identifier of the resource in an external system.

supportID (String)

A number or code that a service desk analyst can ask the person for when the person contacts the service desk for support.

teamIds ([ID!])

Teams this person belongs to.

timeFormat24h (Boolean)

Whether the person prefers to see times displayed within the 4me service in the 24-hour format or not (in which case the 12-hour format is applied).

timeZone (TimeZone)

The time zone in which the person normally resides.

uiExtensionId (ID)

UI extension that is to be applied to the record.

vip (Boolean)

Whether the person is a very important person.

workHoursId (ID)

Calendar that represents the work hours of the person.

Return Fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

errors ([ValidationError!])

Errors encountered during the mutation.

person (Person)

Record after mutation.