Arlo

REST Auth API: Contacts

Contact resources represent an individual or person entity within the platform. A contact may be a registrant on an event, a presenter, a system administrator, or all of these.

Contacts are described by a name, email, integration codes and phone numbers. In addition to this basic information, contacts have a number of linked sub-resources that describe other details such as their postal address, job and organisation, registrations and marketing details.

This resource supports retrieval of individual contact instances, collections of contacts (with filters), creating new contacts, and updating existing contacts.

This entity also supports CustomFields.

Merged contacts

Integrators keeping contacts synchronised with an external system should note that some records can be deleted without notice due to merges between two contact resources. HTTP GET requests to resources moved due to a merge will return a HTTP 308 Permanent Redirect status with headers referring to the merged contact URI and the original ContactMergeRequest. To keep the external system consistent, integrators should query both this resource and also the ContactMergeRequests resource to identify merge operations that will have moved tracked contact records.

Contacts instance resource

Resource URI

/api/2012-02-01/auth/resources/contacts/{ContactID}/

General structure

<Contact>
  <ContactID>562</ContactID>
  <UniqueIdentifier>2af1573a-6227-14d9-0fe2-add46279113f</UniqueIdentifier>
  <FirstName>Barry</FirstName>
  <LastName>Jones</LastName>
  <Email>barry@example.org</Email>
  <CodePrimary>JONESBA01</CodePrimary>
  <PhoneWork>04 9700 19332</PhoneWork>
  <PhoneHome>04 9712 00234</PhoneHome>
  <PhoneMobile>021 1234 56890</PhoneMobile>
  <Status>Active</Status>
  <CreatedDateTime>2011-10-17T03:51:29.577Z</CreatedDateTime>
  <LastModifiedDateTime>2011-10-19T02:55:42.412Z</LastModifiedDateTime>
  <Link rel="self" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/CustomFields" type="application/xml" title="CustomFields" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/customfields/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/PostalAddress" type="application/xml" title="PostalAddress" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/postaladdress/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Employment" type="application/xml" title="Employment" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/employment/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/TimeZone" type="application/xml" title="TimeZone" href="https://demo.arlo.co/api/2012-02-01/auth/resources/timezones/2/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/IntegrationData" type="application/xml" title="IntegrationData" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/integrationdata"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Registrations" type="application/xml" title="Registrations" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/registrations/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Regions" type="application/xml" title="Regions" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/regions/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Marketing" type="application/xml" title="Marketing" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/marketing/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/PresenterIdentity" type="application/xml" title="PresenterIdentity" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/presenteridentity/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Security" type="application/xml" title="Security" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/security/"/>
</Contact>

Resource properties

Property Description
ContactID An integer value that uniquely identifies this resource within the platform. This value is read-only.
UniqueIdentifier A GUID value that uniquely identifies this resource across any platform. This value is read-only.
FirstName A string representing the first name of this individual, up to 32 characters long.
LastName A string representing the last name of this individual, up to 32 characters long.
Email A string representing the email of this individual, up to 128 characters long.
PhoneWork A string representing the work contact phone number of this individual, up to 32 characters long.
PhoneHome A string representing the home contact phone number of this individual, up to 32 characters long.
PhoneMobile A string representing the home contact mobile phone number of this individual, up to 32 characters long.
CodePrimary A string representing an internal (primary) code used to reference this contact, up to 50 characters long. This property is useful for storing and managing identifier values from external systems.
Status A ContactStatus value representing the current state of this contact, such as active or inactive (archived).
CreatedDateTime A UTC DateTime value indicating when this resource was created. This value is read-only.
LastModifiedDateTime A UTC DateTime value indicating when this resource was last modified. This value is read-only.
Link (title) Description
CustomFields Reference to CustomFields associated with this contact.
PostalAddress Reference to an Address resource representing the postal address for this contact.
Employment Reference to a ContactEmployment resource representing details regarding the position and Organisation that employs this contact.
TimeZone Reference to a TimeZone resource representing the preferred/local time zone for this contact.
Regions Reference to a collection of Region links representing the regions this contact is associated with.
IntegrationData Reference to a IntegrationData resource containing integration-specific attributes for this contact.
Registrations Reference to a collection of Registration links representing registrations associated with this contact. Note this link does not support inline expansion.
Marketing Reference to a ContactMarketing resource link representing marketing data associated with this contact.
PresenterIdentity Reference to a ContactPresenterIdentity resource link representing presenter information associated with this contact. Available only if the contact is (or has previously been) a presenter of one or more events. Omitted if the contact has no presenter information.
Security Reference to a ContactSecurity resource link representing security information associated with this contact.

HTTP GET

Returns a representation of a Contact, including the properties and links above.

Optional parameters
Parameter Description
expand Expression referencing Link elements to expand when generating the response. See link expansion.
Response

See HTTP response status codes for a general overview of all possible API status codes. Common response codes for GET operations are listed below.

Status Description
200 OK Resource was successfully retrieved.
308 Permanent Redirect Contact has been merged with another resource. HTTP response will contain two headers:
  • Location: URI referencing the new merged Contact.
  • X-MergeRequest: URI referencing the ContactMergeRequest resulting in this record being deleted.
Example

GET /api/2012-02-01/auth/resources/contacts/562/

<Contact>
  <ContactID>562</ContactID>
  <UniqueIdentifier>2af1573a-6227-14d9-0fe2-add46279113f</UniqueIdentifier>
  <FirstName>Barry</FirstName>
  <LastName>Jones</LastName>
  <Email>barry@example.org</Email>
  <CodePrimary>JONESBA01</CodePrimary>
  <CodeSecondary>934-223-4423</CodeSecondary>
  <Status>Active</Status>
  <CreatedDateTime>2011-10-17T03:51:29.577Z</CreatedDateTime>
  <LastModifiedDateTime>2011-10-19T02:55:42.412Z</LastModifiedDateTime>
  <Link rel="self" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/PostalAddress" type="application/xml" title="PostalAddress" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/postaladdress/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Employment" type="application/xml" title="Employment" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/employment/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/TimeZone" type="application/xml" title="TimeZone" href="https://demo.arlo.co/api/2012-02-01/auth/resources/timezones/2/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Registrations" type="application/xml" title="Registrations" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/registrations/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Regions" type="application/xml" title="Regions" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/regions/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Marketing" type="application/xml" title="Marketing" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/marketing/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Security" type="application/xml" title="Security" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/security/"/>
</Contact>

HTTP POST

Not supported.

HTTP PUT

Performs an update of a Contact by replacing the entire representation with a new copy.

The submitted Contact representation must be complete. Omitted properties will be updated to null, and omitted links (such as addresses and employment information) will deleted if they previously existed. This operation should always be executed using a modified instance from a previous HTTP GET request.

Response

See HTTP response status codes for a general overview of all possible API status codes. Common response codes for PUT operations are listed below.

Status Description
200 OK Resource was successfully updated.
400 Bad Request HTTP request body contains malformed or invalid parameters.
409 Conflict Resource could not be updated because it contains values that conflict with those on the server.
Example 1

Simple update of an existing contact. The operation also includes a new PostalAddress for the contact, overwriting any previous value.

PUT https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/ HTTP/1.1
Accept: application/xml
Accept-Encoding: gzip, deflate
Content-Type: application/xml
Content-Length: 1769
<Contact>
  <ContactID>562</ContactID>
  <UniqueIdentifier>2af1573a-6227-14d9-0fe2-add46279113f</UniqueIdentifier>
  <FirstName>Barry</FirstName>
  <LastName>Jones</LastName>
  <Email>barry@example.org</Email>
  <CodePrimary>JONESBA01</CodePrimary>
  <CodeSecondary>934-223-4423</CodeSecondary>
  <Status>Active</Status>
  <Link rel="self" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/PostalAddress" type="application/xml" title="PostalAddress" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/postaladdress/">
    <Address>
      <StreetLine1>98 Wallacetown Quay</StreetLine1>
      <StreetLine2>PO Box 98442</StreetLine2>
      <SuburbOrRegion>Northcote</SuburbOrRegion>
      <City>Metropolis</City>
      <PostCode>9332</PostCode>
      <Country>New Zealand</Country>
    </Address>
  </Link>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Employment" type="application/xml" title="Employment" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/employment/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/TimeZone" type="application/xml" title="TimeZone" href="https://demo.arlo.co/api/2012-02-01/auth/resources/timezones/2/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Registrations" type="application/xml" title="Registrations" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/registrations/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Regions" type="application/xml" title="Regions" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/regions/"/>
</Contact>
Example 2

Update an existing contact, and clear some existing values. Note the XML representation does not include a CodePrimary value, or any Link entities for PostalAddress, Employment or Marketing. Any existing values for these will be deleted as part of the operation.

PUT https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/ HTTP/1.1
Accept: application/xml
Accept-Encoding: gzip, deflate
Content-Type: application/xml
Content-Length: 936
<Contact>
  <ContactID>562</ContactID>
  <UniqueIdentifier>2af1573a-6227-14d9-0fe2-add46279113f</UniqueIdentifier>
  <FirstName>Barry</FirstName>
  <LastName>Jones</LastName>
  <Email>barry@example.org</Email>
  <Status>Active</Status>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/TimeZone" type="application/xml" title="TimeZone" href="https://demo.arlo.co/api/2012-02-01/auth/resources/timezones/2/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Registrations" type="application/xml" title="Registrations" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/registrations/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Regions" type="application/xml" title="Regions" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/regions/"/>
</Contact>

HTTP DELETE

Not supported.

HTTP PATCH

Performs a partial update of a Contact by replacing parts of the representation with data from the request. Note that our PATCH implementation follows the draft RFC 5261 standard. Note that PATCH requests will be interpreted according to the RBAC permissions of the identity of the user on behalf of whom a request is being made.

The submitted Contact representation can be/is often incomplete. Omitted properties will be ignored for the purposes of update.

Response

See HTTP response status codes for a general overview of all possible API status codes. Common response codes for PATCH operations are listed below.

Status Description
200 OK Resource was successfully updated.
400 Bad Request HTTP request body contains malformed or invalid parameters or is invalid according to our implementation of RFC 5261.
409 Conflict Resource could not be updated because it contains values that conflict with those on the server.
Example 1 - replacement

Simple update of the first and last names of an existing contact. Note the RFC style and nature of the XPath selector used in the sel attribut eto target a specific part of the object graph for update.

PATCH https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/3123/ HTTP/1.1
Accept: application/xml
Accept-Encoding: gzip, deflate
Content-Type: application/xml
Content-Length: 103
<?xml version="1.0" encoding="UTF-8"?>
<diff>
  <replace sel="Contact/FirstName/text()[1]">James</replace>
  <replace sel="Contact/LastName/text()[1]">McDonald</replace>
</diff>
Example 2 - add an address (related entity)

Addition of a postal address to an existing contact that lacks one. Note the manner in which the Link element must be used to contain the related address entity.

PATCH https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/4423/ HTTP/1.1
Accept: application/xml
Accept-Encoding: gzip, deflate
Content-Type: application/xml
Content-Length: 309
<?xml version="1.0" encoding="UTF-8"?>
<diff>
  <add sel="Contact">
    <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/PostalAddress" type="application/xml" title="PostalAddress" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/4423/postaladdress/">
      <Address>
        <StreetLine1>21 Lime Tree Grove</StreetLine1>
        <City>London</City>
      </Address>
    </Link>
  </add>
</diff>
Example 3 - bad request

Attempted update of the grade of an existing contact but with a malformed patch document.

PATCH https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/1010/ HTTP/1.1
Accept: application/xml
Accept-Encoding: gzip, deflate
Content-Type: application/xml
Content-Length: 217
<?xml version="1.0" encoding="UTF-8"?>
<diff>
  <replace sel="ContactFirstName/text()[1]">George</replace>
</diff>

As the selector element is malformed (missing /), an error is returned along with an HTTP status of 400:

<?xml version="1.0" encoding="UTF-8"?>
<ApiException>
  <Code>BadRequest</Code>
  <Message>Path ContactFirstName/text()[1] did not match a node (line = 2, position = 3)</Message>
</ApiException>

Contact collection resource

The Contact collection resource represents the set of Contact resources on the platform.

Resource URI

/api/2012-02-01/auth/resources/contacts/

HTTP GET

Returns a representation of the collection as a set of Link elements which can be followed to access individual Contact resources, or link expansion can be used via the expand query parameter to inline the entities with the HTTP GET response. See querying collections for general information on handling resource collections.

Optional parameters
Parameter Description
expand Expression referencing Link elements to expand when generating the response. See link expansion.
filter A filter expression to apply to the collection. See collection filters. The following properties (and link titles) may be used in filter expressions:
  • ContactID
  • UniqueIdentifier
  • FirstName
  • LastName
  • Email
  • CodePrimary
  • Status
  • CreatedDateTime
  • LastModifiedDateTime
  • PostalAddress
  • Employment
  • TimeZone
orderby A sort expression to apply to the collection. See collection sorting. The following properties may be used in sort expressions:
  • ContactID
  • FirstName
  • LastName
  • Email
  • CodePrimary
  • CreatedDateTime
  • LastModifiedDateTime
skip Returns a subset of records from the collection, starting at index N+1 specified by this parameter. The skip and top parameters are generally used for collection paging.
top Returns a subset of records from the collection, starting at index 0 or index skip, and returns the first N records. The skip and top parameters are generally used for collection paging.
Example 1

Retrieve a collection of Contact links with the default parameters, and no link expansion.

GET /api/2012-02-01/auth/resources/contacts/

<Contacts>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/Contact" type="application/xml" title="Contact" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/Contact" type="application/xml" title="Contact" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/563/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/Contact" type="application/xml" title="Contact" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/564/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/Contact" type="application/xml" title="Contact" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/565/"/>
  ...
  <Link rel="next" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/?skip=100"/>
  <Link rel="self" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/"/>
</Contacts>
Example 2

Retrieve a collection of Contact links with the default parameters, with Contact link expansion.

GET /api/2012-02-01/auth/resources/contacts/?expand=Contact

<Contacts>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/Contact" type="application/xml" title="Contact" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/">
    <Contact>
      <ContactID>562</ContactID>
      <UniqueIdentifier>2af1573a-6227-14d9-0fe2-add46279113f</UniqueIdentifier>
      <FirstName>Barry</FirstName>
      <LastName>Jones</LastName>
      <Email>barry@example.org</Email>
      <Status>Active</Status>
      <CreatedDateTime>2011-10-17T03:51:29.577Z</CreatedDateTime>
      <LastModifiedDateTime>2011-10-19T02:55:42.412Z</LastModifiedDateTime>
      <Link rel="self" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/PostalAddress" type="application/xml" title="PostalAddress" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/postaladdress/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Employment" type="application/xml" title="Employment" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/employment/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/TimeZone" type="application/xml" title="TimeZone" href="https://demo.arlo.co/api/2012-02-01/auth/resources/timezones/2/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Registrations" type="application/xml" title="Registrations" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/registrations/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Regions" type="application/xml" title="Regions" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/562/regions/"/>
    </Contact>
  </Link>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/Contact" type="application/xml" title="Contact" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/563/">
    <Contact>
      <ContactID>563</ContactID>
      <UniqueIdentifier>af1c9559-a84a-4c60-bcce-7dd98e01fa3f</UniqueIdentifier>
      <FirstName>Sally</FirstName>
      <LastName>Smith</LastName>
      <Email>sally@example.org</Email>
      <Status>Active</Status>
      <CreatedDateTime>2011-10-18T03:42:21.321Z</CreatedDateTime>
      <LastModifiedDateTime>2011-10-19T01:30:11.112Z</LastModifiedDateTime>
      <Link rel="self" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/563/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/PostalAddress" type="application/xml" title="PostalAddress" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/563/postaladdress/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Employment" type="application/xml" title="Employment" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/563/employment/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/TimeZone" type="application/xml" title="TimeZone" href="https://demo.arlo.co/api/2012-02-01/auth/resources/timezones/2/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Registrations" type="application/xml" title="Registrations" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/563/registrations/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Regions" type="application/xml" title="Regions" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/563/regions/"/>
    </Contact>
  </Link>
  ...
  <Link rel="next" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/?expand=Contact&skip=100"/>
  <Link rel="self" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/?expand=Contact"/>
</Contacts>

HTTP POST

Creates a new Contact in the collection.

The submitted Contact representation must be complete with optional inline representations of PostalAddress and Employment, but must not include system-managed properties:

  • ContactID
  • UniqueIdentifier
  • CreatedDateTime
  • LastModifiedDateTime
Response

See HTTP response status codes for a general overview of all possible API status codes. Common response codes for POST operations are listed below.

Status Description
201 Created Resource was successfully created. The body of the response will contain the new resource.
400 Bad Request HTTP request body contains malformed or invalid parameters.
409 Conflict Resource could not be created because it contains values that conflict with those on the server.
Example

Create a new contact, including inline PostalAddress and Employment information for the new contact, and make the contact a Presenter.

The API response will include a representation of the contact, including newly-generated values for ContactID and UniqueIdentifier.

POST https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/ HTTP/1.1
Accept: application/xml
Accept-Encoding: gzip, deflate
Content-Type: application/xml
Content-Length: 1769
<Contact>
  <FirstName>Jane</FirstName>
  <LastName>Smith</LastName>
  <Email>jane@example.org</Email>
  <CodePrimary>SMITHJ02</CodePrimary>
  <CodeSecondary>223-112-8422</CodeSecondary>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/PostalAddress" type="application/xml" title="PostalAddress">
    <Address>
      <StreetLine1>98 Wallacetown Quay</StreetLine1>
      <StreetLine2>PO Box 98442</StreetLine2>
      <SuburbOrRegion>Northcote</SuburbOrRegion>
      <City>Metropolis</City>
      <PostCode>9332</PostCode>
      <Country>New Zealand</Country>
    </Address>
  </Link>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Employment" type="application/xml" title="Employment">
    <ContactEmployment>
      <Position>Marketing Site Developer</Position>
      <EmploymentStatus>Contractor, full time</EmploymentStatus>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Organisation" type="application/xml" title="Organisation" href="https://demo.arlo.co/api/2012-02-01/auth/resources/organisations/2/"/>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Manager" type="application/xml" title="Manager" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/328/"/>
    </ContactEmployment>
  </Link>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Security" type="application/xml" title="Security">
    <ContactSecurity>
      <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/roles" type="application/xml" title="Roles">
        <Roles>
          <Role>Presenter</Role>
        </Roles>
      </Link>
    </ContactSecurity>
  </Link>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/TimeZone" type="application/xml" title="TimeZone" href="https://demo.arlo.co/api/2012-02-01/auth/resources/timezones/2/"/>
</Contact>
HTTP/1.1 201 Created
Content-Length: 2042
Content-Type: application/xml; charset=utf-8
<Contact>
  <ContactID>33223</ContactID>
  <UniqueIdentifier>2af1573a-6227-14d9-0fe2-add46279113f</UniqueIdentifier>
  <FirstName>Jane</FirstName>
  <LastName>Smith</LastName>
  <Email>jane@example.org</Email>
  <CodePrimary>SMITHJ02</CodePrimary>
  <CodeSecondary>223-112-8422</CodeSecondary>
  <CreatedDateTime>2011-10-17T03:51:29.577Z</CreatedDateTime>
  <LastModifiedDateTime>2011-10-19T02:55:42.412Z</LastModifiedDateTime>
  <Link rel="self" type="application/xml" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/33223/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/PostalAddress" type="application/xml" title="PostalAddress" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/33223/postaladdress/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Employment" type="application/xml" title="Employment" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/33223/employment/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/TimeZone" type="application/xml" title="TimeZone" href="https://demo.arlo.co/api/2012-02-01/auth/resources/timezones/2/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Registrations" type="application/xml" title="Registrations" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/33223/registrations/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Regions" type="application/xml" title="Regions" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/33223/regions/"/>
  <Link rel="http://schemas.arlo.co/api/2012/02/auth/related/Security" type="application/xml" title="Security" href="https://demo.arlo.co/api/2012-02-01/auth/resources/contacts/33223/security/"/>
</Contact>

HTTP PUT

Not supported.

HTTP DELETE

Not supported.