API v1 Reference

Link Individual to Organization

This request is used to make an individual contact become an organizational contact of an organization account.

REST

Request

https://api.neoncrm.com/neonws/services/api/account/linkIndividualToOrganization?userSessionId=[session id]&individualContactId=5192&organizationAccountId=3553&isPrimaryContact=true&startDate=2005-11-01&address.isPrimaryAddress=true&address.isShippingAddress=false&address.addressType.name=Home&address.addressLine1=addressLine1

Response

{ "linkIndividualToOrganizationResponse": { 
    "operationResult": "SUCCESS", 
    "responseDateTime": "2012-12-27T03:17:46.972-06:00" } 
}

SOAP

Request

<soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:neon="http://www.z2systems.com/schemas/neonws/">
   <soapenv:header>
       <soapenv:body>
          <neon:linkindividualtoorganizationrequest>
             <usersessionid>T1359339042886</usersessionid>
             <individualcontactid>5192</individualcontactid>
             <organizationaccountid>3552</organizationaccountid>
             <isprimarycontact>true</isprimarycontact>
             <iscurrentemployee>false</iscurrentemployee>
             <startdate>2012-12-21</startdate>
             <enddate>2013-08-20</enddate>

                      <address>
                    <isprimaryaddress>true</isprimaryaddress>
                <isshippingaddress>false</isshippingaddress>
                <shippingcompanyname></shippingcompanyname>
                <shippingdeliverto></shippingdeliverto>
                <addresstype>
                   <name>Home</name>
                </addresstype>
                <addressline1>14/29 mars ST link 2</addressline1>
                <addressline2></addressline2>
                <addressline3></addressline3>
                <addressline4></addressline4>
                <city>cheng</city>
                <state>
                   <name>ALABAMA</name>
                </state>
                <province></province>
                <county></county>
                <country>
                   <id>1</id>
                </country>
                <zipcode>6489</zipcode>
                <zipcodesuffix>1</zipcodesuffix>
                <startdate>2012-12-23</startdate>
                <enddate>2013-04-21</enddate>
                      </address>
              <department>dev.0021</department>
              <title>some title</title>
              <organizationemail>aaa@aaa.com</organizationemail>
          </neon:linkindividualtoorganizationrequest>
       </soapenv:body>
    </soapenv:header>
</soapenv:envelope>

Response

<soap:envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:body>
      <ns2:linkindividualtoorganizationresponse xmlns:ns2="http://www.z2systems.com/schemas/neonws/">
         <operationresult>SUCCESS</operationresult>
         <responsedatetime>2013-01-08T00:33:13.908-06:00</responsedatetime>
      </ns2:linkindividualtoorganizationresponse>
   </soap:body>
</soap:envelope>

Request Parameters

Name Required Description
individualContactId Yes Contact ID (not Account ID) of the individual account
organizationAccountId Yes Account ID of the organizaiton account
isPrimaryContact Yes Indicates if this contact is the current primary contact in this organization. Possible values: true, false.
isCurrentEmployee Possible values: true, false.
startDate Format: YYYY-MM-DD
endDate Format: YYYY-MM-DD
address.isPrimaryAddress Whether this address is the primary address. Possible values: true, false
address.isShippingAddress Whether this address should be considered a shipping address. Possible values: true, false
address.addressType.id Possible values can be retrieved from the List Address Types method.
address.addressType.name Possible values can be retrieved from the List Address Types method.
address.addressLine1
address.addressLine2
address.addressLine3
address.addressLine4
address.city
address.state.code Possible values can be retrieved from the List States method.
address.state.name Possible values can be retrieved from the List States method.
address.province Only used for countries other than US and Canada. Canadian provinces can be found in the States field.
address.county
address.country.id Possible values can be retrieved from the List Countries method.
address.country.name Possible values can be retrieved from the List Countries method.
address.zipCode
address.zipCodeSuffix
address.startDate Format: YYYY-MM-DD
address.endDate Format: YYYY-MM-DD
department
title
organizationEmail

Error Codes

Code Text Description
10024 Contact id is required.
10025 Contact id is invalid.
10032 Organization account id is required.
10033 Organization account id is invalid.
10035 Given contact is a primary company contact which cannot be set to non-primary.
10036 Given Account has not been linked yet.