# PersonService

This services creates contacts in 24SevenOffice. The property Id is the primary ID and cannot be specified when creating a new contact. If you specify an Id, this means that you are updating a contact.

WARNING

Please note: It is not possible to create employees through the PersonService.

PersonService (opens new window)
PersonService WSDL (opens new window)

Data Types

# Guides

# Retrieve Contact

Retrive persons by using the GetPersons (opens new window) method or if you need more informtion on that contact, use the GetPersonsDetailed (opens new window) method. We recommend using the GetPersons (opens new window) method if you are able to.

    <GetPersons xmlns="http://24sevenOffice.com/webservices">
      <personSearch>
        <ChangedAfter>2019-01-01T00:00:00</ChangedAfter>
      </personSearch>
    </GetPersons>

# Save a contact

Save a person by using the SavePerson (opens new window) method.

   <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"   xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
     <SavePerson xmlns="http://24sevenOffice.com/webservices">
      <personItem>
        <Comment>Add your comment here</Comment>
        <ConsumerPersonNo>1234567</ConsumerPersonNo>
        <Country>NO</Country>
        <CustomerId>100</CustomerId>
        <DateOfBirth>1995-01-01</DateOfBirth>
        <Department>Development</Department>
        <EmailAddresses>
          <EmailAddress>
            <Description>Work</Description>
            <Type>Primary</Type>
            <Value>Work@Work.com</Value>
          </EmailAddress>
        </EmailAddresses>
        <EmployeeNumber>1234</EmployeeNumber>
        <FaxNumber>
          <Description>Fax Home</Description>
          <Type>Primary</Type>
          <Value>fax@fax.no</Value>
        </FaxNumber>
        <FirstName>Bob</FirstName>
        <Gender>Male</Gender>
        <LastName>Olsen</LastName>
        <Nickname>Bobby</Nickname>
        <PersonalStatus>Single</PersonalStatus>
        <PhoneNumbers>
          <PhoneNumber>
            <Description>Work</Description>
            <Type>Mobile</Type>
            <Value>12345678</Value>
          </PhoneNumber>
        </PhoneNumbers>
        <PostAddress>
          <City>Skien</City>
          <Country>NO</Country>
          <County>Telemark</County>
          <Description>Home</Description>
          <PostalArea>Telemark</PostalArea>
          <PostalCode>1234</PostalCode>
          <State>Buskerud</State>
          <Street>Teststreet 1</Street>
          <Type>Post</Type>
        </PostAddress>
        <RelationData>
          <RelationData>
            <CustomerId>1234</CustomerId>
            <Email>Olsen@email.no</Email>
            <Mobile>12345678</Mobile>
            <Phone>87654321</Phone>
            <Title>Boss</Title>
          </RelationData>
         </RelationData>
        <Url>homepage url</Url>
        <Workplace>Industries AS</Workplace>
        <WorkPosition>Boss</WorkPosition>
        <IsPrivate>false</IsPrivate>
        <HourCost>250</HourCost>
      </personItem>
    </SavePerson>
  </soap:Body>
</soap:Envelope>

# Add relation to a contact

Use the MakeRelation (opens new window) method to add a relation to a contact.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <MakeRelation xmlns="http://24sevenOffice.com/webservices">
      <relation>
        <ContactId>123456</ContactId>
        <CustomerId>100</CustomerId>
        <Email>olsen@email.no</Email>
        <Mobile>12345678</Mobile>
        <Phone>87654321</Phone>
        <Title>Relation Olsen</Title>
      </relation>
    </MakeRelation>
  </soap:Body>
</soap:Envelope>

# Retrieve relations from a contact

The method GetRelations (opens new window) is used to retrieve relations or use the GetRelationsChangedAfter (opens new window) method to receive relations created after a specific date.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetRelations xmlns="http://24sevenOffice.com/webservices">
      <personId>123456</personId>
    </GetRelations>
  </soap:Body>
</soap:Envelope>

# Add notes to a contact

To save a note you need to use the AddNote (opens new window) method.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AddNote xmlns="http://24sevenOffice.com/webservices">
      <note>
        <Subject>Note 1</Subject>
        <Description>Note description</Description>
        <PersonId>123456</PersonId>
      </note>
    </AddNote>
  </soap:Body>
</soap:Envelope>

# Retrieve notes from a contact

To retrieve notes you need to use the GetNotes (opens new window) method. And you have to input the personId as a parameter.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetNotes xmlns="http://24sevenOffice.com/webservices">
      <personId>123456</personId>
    </GetNotes>
  </soap:Body>
</soap:Envelope>

# Delete notes

To delete a note you need to use the DeleteNote (opens new window) method. You can also use the DeleteNoteById (opens new window) to delete a note. This method needs only the NoteId.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <DeleteNote xmlns="http://24sevenOffice.com/webservices">
      <note>
        <Id>1234</Id>
        <Subject>Note 1</Subject>
        <Description>Delete note</Description>
        <EmployeeId>12345678</EmployeeId>
        <DateAdded>2010-01-01</DateAdded>
        <Date>2020-01-01</Date>
        <PersonId>123456</PersonId>
      </note>
    </DeleteNote>
  </soap:Body>
</soap:Envelope>

# Retrieve contact id

To retrieve a contact id or personId use the GetPersonId (opens new window) or the GetPersonIdsByUserName (opens new window) method.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetPersonId xmlns="http://24sevenOffice.com/webservices">
      <consumerPersonNo>1234</consumerPersonNo>
    </GetPersonId>
  </soap:Body>
</soap:Envelope>

# Methods

Method Input type Return type Description
AddCategoryToPerson (opens new window) personId(Long), categoryId(Int) Adds a CRM Category to a person
RemoveCategoryFromPerson (opens new window) personId(Long), categoryId(Int) Removes a CRM Category from a person
GetPersonCategoryList (opens new window) personId(Long) int[] Returns a list of category ids for a specific person
GetPersonArrayCategoryList (opens new window) personIds(Int[]) PersonCategories[] Returns a list of category ids for an array of persons
GetCategoryList (opens new window) - Category[] Returns a list of all CRM categories
AddNote (opens new window) NoteData int Adds a note and returns the Id of the added note
DeleteNote (opens new window) NoteData Deletes a note
DeleteNoteById (opens new window) noteId(Int) Deletes a note by using the id
GetNotes (opens new window) personId(Long) NoteData[] Gets all notes for a specific person
GetPersonId (opens new window) consumerPersonNo(String) long Gets 24SevenOffice’s Person Id that corresponds to the given Consumer Person Id
GetPersonIdsByUserName (opens new window) username(String) long[] Gets a list of Person Ids from a username in 24SO’s system
GetPersons (opens new window) PersonSearchParameters PersonItem[] Gets a list of persons
GetPersonsDetailed (opens new window) PersonSearchParameters PersonItem[] Gets a list of persons with more detailed information
SavePerson (opens new window) PersonItem long Saves a person and returns its ID
GetRelations (opens new window) -
GetRelationsChangedAfter (opens new window) datetime
MakeRelation (opens new window) RelationData bool Insert/update relationdata between a company and a contact.