For the complete experience, please enable JavaScript in your browser. Thank you!

  • Creative Cloud
  • Photoshop
  • Illustrator
  • InDesign
  • Premiere Pro
  • After Effects
  • Lightroom
  • See all
  • See plans for: businesses photographers students
  • Document Cloud
  • Acrobat DC
  • eSign
  • Stock
  • Elements
  • Marketing Cloud
  • Analytics
  • Audience Manager
  • Campaign
  • Experience Manager
  • Media Optimizer
  • Target
  • See all
  • Acrobat Reader DC
  • Adobe Flash Player
  • Adobe AIR
  • Adobe Shockwave Player
  • All products
  • Creative Cloud
  • Individuals
  • Photographers
  • Students and Teachers
  • Business
  • Schools and Universities
  • Marketing Cloud
  • Document Cloud
  • Stock
  • Elements
  • All products
  • Get Support
    Find answers quickly. Contact us if you need to.
    Start now >
  • Learn the apps
    Get started or learn new ways to work.
    Learn now >
  • Ask the community
    Post questions and get answers from experts.
    Start now >
    • About Us
    • Careers At Adobe
    • Investor Relations
    • Privacy  |  Security
    • Corporate Responsibility
    • Customer Showcase
    • Events
    • Contact Us
News
    • 3/22/2016
      Adobe Summit 2016: Are You An Experience Business?
    • 3/22/2016
      Adobe Announces Cross-Device Co-op to Enable People-Based Marketing
    • 3/22/2016
      Adobe and comScore Advance Digital TV and Ad Measurement
    • 3/22/2016
      Adobe Marketing Cloud Redefines TV Experience
ColdFusion Help / 

Using the Contact APIs

Adobe Community Help


Applies to

  • ColdFusion

Contact support

 
By clicking Submit, you accept the Adobe Terms of Use.
 

See the Contact Functions to understand these examples.

Creating contacts

<cfinclude template="/CFIDE/cfclient/useragent.cfm">
<cfclientsettings enableDeviceAPI=true>

<cfclient>
 
<cfset res = cfclient.contacts.create('Joe','1234567890','joe@mycompany.com',true)>
<cfset document.getElementById('result').innerHTML="Options object: #JSON.stringify(Object.keys(res))#"> 

</cfclient>

<div id="result"/>

Adding fields to the contact

<cfinclude template="/CFIDE/cfclient/useragent.cfm">
<cfclientsettings enableDeviceAPI=true>

<cfclient>

<cfset res.addPhoneNumber("5678234","work",true)>
<cfset res.addEmail("joe@gmail.com","home",true)>
 
<cfset cntadr=cfclient.contacts.createAddress("First street", "North", "Indian", "India","12345", "Good address form", "home", "true")>
<cfset res.addAddress(cntadr)>
 
<cfset cntorg=cfclient.contacts.createOrganization("SciTech", "Science", "Science Technology", "Education","true")>
<cfset res.addOrganization(cntorg)>

<cfset res.addIm("myIMHandle","home",true)>

<cfset res.addCategory("Friends","home",true)>
<cfset res.addURL("www.joe.com","home",true)>
<cfset res.addPhoto("myDir/img.jpg","home",true)>
 
<cfset cfclient.contacts.save(res)>

</cfclient>

Finding a contact

<cfclientsettings enableDeviceAPI=true>
<cfclient>
 
<!--- Searching all fields --->
<cfset cntlst=cfclient.contacts.find("Joe",["*"])>
 
<cfset document.getElementById('result').innerHTML=document.getElementById('result1').innerHTML+"Number of contacts - #arrayLen(cntlst)#"> 
<cfscript>
for (i = 1; i <= #arrayLen(cntlst)#; i = i + 1) {
writeOutput("<br><br>");
writeOutput(iter(cntlst[i])); 
} 
</cfscript>
 
<!--- Searching only the displayName field --->
<cfset cntlst=cfclient.contacts.find("Joe",["name","displayName"])>
 
<cfset document.getElementById('result').innerHTML=document.getElementById('result2').innerHTML+"Number of contacts - #arrayLen(cntlst)#">

<cfscript>
for (i = 1; i <= #arrayLen(cntlst)#; i = i + 1) {
writeOutput("<br><br>");
writeOutput(iter(cntlst[i])); 
} 
</cfscript>


<!--- Searching in the displayName and phoneNumbers fields --->
<cfset cntlst=cfclient.contacts.find("user1_1",["phoneNumbers,displayName"])>
<cfset document.getElementById('result').innerHTML=document.getElementById('result3').innerHTML+"Number of contacts - #arrayLen(cntlst)#">
<cfscript>
for (i = 1; i <= #arrayLen(cntlst)#; i = i + 1) {
writeOutput("<br><br>");
writeOutput(iter(cntlst[i])); 
} 
</cfscript>

</cfclient>
 
<div id="result1"/>
<div id="result2"/>
<div id="result3"/>

Getting all the contacts

<cfclientsettings enableDeviceAPI=true>
<cfclient>
 
<cfoutput>Getting all contacts</cfoutput>
<cfset cntlst=cfclient.contacts.getAllContacts(["*"])>
<cfset document.getElementById('result').innerHTML=document.getElementById('result3').innerHTML+"Number of contacts - #arrayLen(cntlst)#">
<cfscript>
for (i = 1; i <= #arrayLen(cntlst)#; i = i + 1) {
writeOutput("<br><br>");
writeOutput(iter(cntlst[i])); 
} 
</cfscript>
 
<cfoutput>Getting only the phone numbers</cfoutput>
<cfset cntlst=cfclient.contacts.getAllContacts(["phoneNumbers"])>
<cfset document.getElementById('result').innerHTML=document.getElementById('result3').innerHTML+"Number of contacts - #arrayLen(cntlst)#">
<cfscript>
for (i = 1; i <= #arrayLen(cntlst)#; i = i + 1) {
writeOutput("<br><br>");
writeOutput(iter(cntlst[i])); 
} 
</cfscript>

<cfoutput>Getting only the display names and phone numbers</cfoutput>
<cfset cntlst=cfclient.contacts.getAllContacts(["phoneNumbers,displayName"])>
<cfset document.getElementById('result').innerHTML=document.getElementById('result3').innerHTML+"Number of contacts - #arrayLen(cntlst)#">
<cfscript>
for (i = 1; i <= #arrayLen(cntlst)#; i = i + 1) {
writeOutput("<br><br>");
writeOutput(iter(cntlst[i])); 
} 
</cfscript>


</cfclient>

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy

Choose your region United States (Change)   Products   Downloads   Learn & Support   Company
Choose your region Close

Americas

Europe, Middle East and Africa

Asia Pacific

  • Brasil
  • Canada - English
  • Canada - Français
  • Latinoamérica
  • México
  • United States
  • Africa - English
  • Österreich - Deutsch
  • Belgium - English
  • Belgique - Français
  • België - Nederlands
  • България
  • Hrvatska
  • Cyprus - English
  • Česká republika
  • Danmark
  • Eesti
  • Suomi
  • France
  • Deutschland
  • Greece - English
  • Magyarország
  • Ireland
  • Israel - English
  • ישראל - עברית
  • Italia
  • Latvija
  • Lietuva
  • Luxembourg - Deutsch
  • Luxembourg - English
  • Luxembourg - Français
  • Malta - English
  • الشرق الأوسط وشمال أفريقيا - اللغة العربية
  • Middle East and North Africa - English
  • Moyen-Orient et Afrique du Nord - Français
  • Nederland
  • Norge
  • Polska
  • Portugal
  • România
  • Россия
  • Srbija
  • Slovensko
  • Slovenija
  • España
  • Sverige
  • Schweiz - Deutsch
  • Suisse - Français
  • Svizzera - Italiano
  • Türkiye
  • Україна
  • United Kingdom
  • Australia
  • 中国
  • 中國香港特別行政區
  • Hong Kong S.A.R. of China
  • India - English
  • 日本
  • 한국
  • New Zealand
  • Southeast Asia (Includes Indonesia, Malaysia, Philippines, Singapore, Thailand, and Vietnam) - English
  • 台灣

Commonwealth of Independent States

  • Includes Armenia, Azerbaijan, Belarus, Georgia, Moldova, Kazakhstan, Kyrgyzstan, Tajikistan, Turkmenistan, Ukraine, Uzbekistan

Copyright © 2016 Adobe Systems Incorporated. All rights reserved.

Terms of Use | Privacy | Cookies

AdChoices