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.