Service: Person

Reading and editing persons

Provices read/write access to the person Data Objects.

Functions

ResultName / ParamsComment
GetResultperson.GetReturns a filtered list of Person Objects.
filterstring(Optional) Filter expression which determines the result set.
selectstring[](Optional) List of properties that should be contained in the result objects.
limitint(Optional) Maximum amount of Objects that should be returned. (Max : 100000)
GetResultperson.GetReturns a filtered list of Person Objects as a follow up to a previous Get call.
contextstringThe context received within the last get result. Mandatory for subsequent get calls with pagination.
scrollintScrolls through the result set with 'Next' or 'Prev'. Used for pagination. See EnumPaginationScroll.
offsetint(Optional) Offset of the first Object in the result set that should be returned. Used for direct pagination.
limitint(Optional) Maximum amount of Objects that should be returned. (Max : 100000)
Personperson.GetOneReturns a single Person Object identified by the given id.
idguidThe Person's id.
selectstring[](Optional) List of properties that should be contained in the result object.
guidperson.CreateCreates the Person in the system and returns the id of the Person. The Person must not have an id. If an id is set, the creation is rejected and an empty id is returned.
objectPersonThe Person to create.
boolperson.UpdateUpdates a Person with data from the provided Object.
objectPersonPerson to update
boolperson.SetSets specific properties of a Person Object.
idguidId of the Person to modify.
propsvalue{}List of properties that should be set. Property paths may be used as ids to address any partial aspect of the Object.
boolperson.DeleteDeletes a Person Object. Returns true if successfully deleted or if no such Object existed to begin with.
idguidId of the Person to delete.
boolperson.BulkModifyPerforms a bulk of changes at once.
createPerson[](Optional) List of Person Objects to create.
updatePerson[](Optional) List of Person Objects to update.
setObjectAspect[](Optional) List of Person Object properties to set.
deleteguid[](Optional) List of Person ids to delete.

Notifications

Name / ParamsComment
person.CreatedNotifies about new Person Objects.
objectsPerson[]Newly created Person Objects.
person.UpdatedNotifies about updated Person Objects.
objectsPerson[]Changed Person Objects.
person.DeletedNotifies about deleted Person Objects.
idsguid[]Ids of the deleted Person Objects.

Objects

Person

Property Type Description
Id guid (Unique, Readonly) Internal unique id of the Person Data Object.
SegmentId guid Assigned data segment.
LastName string
FirstName string
Title string
Company string
Department string
Position string
Street string
Zip string
City string
PhoneCompany string
PhonePrivate string
PhoneMobile string
PhoneMobilePrivate ≥wg 0.5.2 string
PhoneMobileAssistant ≥wg 0.5.2 string
Pager string
Fax string
SipAddress string
Email string
Website string
Language string
Info string
SubstituteId guid
IsSubstituted bool
IsDeactivated ≥wg 0.5.2 bool Whether the person is deactivated.
ExtRef string
EditTime time (Readonly, Not in default set)
EditUser string (Readonly, Not in default set)
Last modified September 25, 2026