Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel2

GET contact_information/show

This method returns information related with a contact information.  Single contact information is returned by each call

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

(mandatory)

...

Identifier  

The identifier of the contact information that should be returned as a result. The allowed contact information identifier fields are the following:

...

fields_set

(optional)

...

List of Strings, comma separated 

...

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

...

Examples

Expand
titleExample 1

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
    {
       "status":
       {
           "message": null,
           "description": null,
           "code": "OK"
       },
       "data":
       {
           "udf_string_10": null,
           "organizational_unit": 0,
           "udf_float_1": 10,
           "udf_string_11": null,
           "udf_float_2": 20,
		   "preferred_language": "ENG",
           "udf_string_12": null,
           "udf_float_3": 30,
           "udf_string_13": null,
           "udf_float_4": 40,
           "udf_string_14": null,
           "udf_float_5": 50,
           "udf_string_15": null,
           "udf_string_1": "udf string 1",
           "name": "Louis Kozior",
           "udf_string_16": null,
           "udf_float_6": 60,
           "udf_string_2": "udf string 2",
           "udf_float_7": 70,
           "udf_string_3": "udf string 3",
           "privacy_level":
           {
               "number": "8",
               "hierarchy_level": 0,
               "name": "Regular Customers",
               "id": "EDE9CDE326E4F9846A50D5BCF61CD720"
           },
           "company_name": null,
           "udf_float_8": 80,
           "udf_string_4": "udf string 4",
           "udf_string_5": "udf string 5",
           "udf_string_6": "udf string 6",
           "udf_string_7": "udf string 7",
           "udf_string_8": "udf string 16",
           "udf_string_9": null,
           "last_name": "Kozior",
           "id": "1F1D2D0DFD164BFA801BE87CA9E33915",
           "relation_set":
           [
               {
                   "contact":
                   {
                       "last_name": "Kozior",
                       "life_cycle_state": "MARKETING",
                       "middle_name": "Aloz",
                       "company_profile": null,
                       "title": "Sir",
                       "type": "PERSON",
                       "first_name": "Louis",
                       "name": null,
                       "id": "1F1D2D0DFD164BFA801BE87CA9E33915",
                       "company_name": null,
                       "demographics":
                       {
                           "gender": "FEMALE",
                           "passport_number": "CD112234",
                           "social_security_number": "EF112234",
                           "date_of_birth":
                           {
                               "month": 5,
                               "day": 12,
                               "year": 1981
                           },
                           "name_day":
                           {
                               "month": 8,
                               "day": 18
                           },
                           "id_number": "AB112234"
                       }
                   },
                   "notes": null,
                   "type": "Family Member",
                   "id": "52062CE827B445DDA9100F2BDB04F06D"
               }
           ],
           "log_information":
           {
               "updated_date": "2015-04-28T16:51:51",
               "created_by_unit":
               {
                   "community_name": "Internal Community",
                   "group_name": "Main Group",
                   "name": "Admin Unit",
                   "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                   "description": "r1",
                   "alternative_code": "MG"
               },
               "created_date": "2015-04-28T16:51:50",
               "updated_by_unit":
               {
                   "community_name": "Internal Community",
                   "group_name": "Main Group",
                   "name": "Admin Unit",
                   "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                   "description": "r1",
                   "alternative_code": "MG"
               },
               "created_by_user":
               {
                   "person_name": "MPAdministrator",
                   "username": "MPAdministrator",
                   "id": "1",
                   "email": "mp@ministrator.com"
               },
               "updated_by_user":
               {
                   "person_name": "MPAdministrator",
                   "username": "MPAdministrator",
                   "id": "1",
                   "email": "mp@ministrator.com"
               }
           },
           "life_cycle_state": "MARKETING",
           "first_name": "Louis",
           "type": "PERSON",
           "notes": "Marios Lannister 28/4/2015 16:51:51 Family",
           "addresses_set":
           [
               {
                   "care_of": "Maria Kyriacou",
                   "street_number": "8",
                   "udf_string_10": null,
                   "udf_float_1": 10,
                   "udf_string_11": null,
                   "street_name": "Ilia Papakiriakou",
                   "udf_float_2": 20,
                   "udf_string_12": null,
                   "udf_float_3": 30,
                   "udf_string_13": null,
                   "udf_float_4": 40,
                   "udf_string_14": null,
                   "udf_string_15": null,
                   "po_box": "70022",
                   "udf_string_1": "udf string 1",
                   "udf_string_16": null,
                   "udf_string_2": "udf string 2",
                   "floor": 2,
                   "udf_string_3": "udf string 3",
                   "area": "Plati",
                   "udf_string_4": "udf string 4",
                   "district": "Nicosia",
                   "udf_string_5": "udf string 5",
                   "udf_string_6": "udf string 6",
                   "udf_string_7": "udf string 7",
                   "state": "Active",
                   "udf_string_8": "udf string 16",
                   "udf_string_9": null,
                   "country":
                   {
                       "three_character_code": "CYP",
                       "two_character_code": "CY",
                       "name": "CYPRUS",
                       "id": "181",
                       "alternative_code": null
                   },
                   "id": "A939A8F2FF7F4D37AEF3ED5A34A8238E",
                   "postal_code": "3020",
                   "udf_date_1": "2014-05-05T15:49:59",
                   "udf_date_2": "2014-06-05T15:49:59",
                   "udf_date_3": "2014-07-05T15:49:59",
                   "udf_date_4": "2014-08-05T15:49:59",
                   "po_box_postal_code": "AG70022",
                   "apartment_number": "202",
                   "town_city": "Aglanjia",
                   "type": "Home",
                   "municipality": "Aglanjia"
               }
           ],
           "title": "Sir",
           "company_profile":
           {
               "tax_reference_number": null,
               "annual_turnover": null,
               "number_of_employees": null,
               "profile_year": null,
               "established_date": null,
               "industry_sector":
               {
                   "name": "FOREX",
                   "id": "D8ACF18AB4494AD33738A9F4C94E6995",
                   "alternative_code": "FRX"
               },
               "registered_in_country": null,
               "vat_registration_number": null,
               "industry":
               {
                   "name": "Marketing",
                   "id": "31BC2070C79EAE5455BFAD41599C5190",
                   "code": "MK"
               },
               "vat_registration_date": null,
               "vat_registered_by": null,
               "registration_number": null
           },
           "udf_date_1": "2014-05-05T15:49:59",
           "phones_set":
           [
               {
                   "notes": null,
                   "udf_float_1": null,
                   "udf_float_2": null,
                   "udf_date_1": null,
                   "udf_float_3": null,
                   "udf_date_2": null,
                   "number": "22114455",
                   "udf_float_4": null,
                   "udf_date_3": null,
                   "udf_date_4": null,
                   "udf_string_1": null,
                   "udf_string_2": null,
                   "udf_string_3": null,
                   "udf_string_4": null,
                   "udf_string_5": null,
                   "udf_string_6": null,
                   "udf_string_7": null,
                   "state": "Active",
                   "udf_string_8": null,
                   "country":
                   {
                       "three_character_code": "USA",
                       "two_character_code": "US",
                       "name": "UNITED STATES",
                       "id": "127",
                       "alternative_code": null
                   },
                   "full_number": "00122114455",
                   "type": "Landline",
                   "id": "F593DEF1C332469B939E358A28773FB9",
                   "area_code": "1"
               }
           ],
           "udf_date_2": "2014-06-05T15:49:59",
           "udf_date_3": "2014-07-05T15:49:59",
           "udf_date_4": "2014-08-05T15:49:59",
           "udf_date_5": null,
           "udf_date_6": null,
           "demographics":
           {
               "gender": "FEMALE",
               "passport_issued_by_country":
               {
                   "three_character_code": "GRC",
                   "two_character_code": "GR",
                   "name": "GREECE",
                   "id": "209",
                   "alternative_code": null
               },
               "passport_number": "CD112234",
               "social_security_number": "EF112234",
               "country_of_residence":
               {
                   "three_character_code": "CYP",
                   "two_character_code": "CY",
                   "name": "CYPRUS",
                   "id": "181",
                   "alternative_code": null
               },
               "industry_sector":
               {
                   "name": "FOREX",
                   "id": "D8ACF18AB4494AD33738A9F4C94E6995",
                   "alternative_code": "FRX"
               },
               "date_of_birth":
               {
                   "month": 5,
                   "day": 12,
                   "year": 1981
               },
               "name_day":
               {
                   "month": 8,
                   "day": 18
               },
               "id_number": "AB112234",
               "id_issued_by_country":
               {
                   "three_character_code": "CYP",
                   "two_character_code": "CY",
                   "name": "CYPRUS",
                   "id": "181",
                   "alternative_code": null
               },
               "industry":
               {
                   "name": "Marketing",
                   "id": "31BC2070C79EAE5455BFAD41599C5190",
                   "code": "MK"
               }
           },
           "udf_date_7": null,
           "udf_date_8": null,
           "owned_by_group":
           {
               "community_name": "Internal Community",
               "name": "Main Group",
               "id": "84F33366CB592BAAE7E2044D93611C6A",
               "description": "Main Group",
               "alternative_code": "MG1"
           },
           "middle_name": "Aloz",
           "emails_set":
           [
               {
                   "notes": null,
                   "udf_float_1": null,
                   "udf_float_2": null,
                   "udf_date_1": null,
                   "udf_float_3": null,
                   "udf_date_2": null,
                   "udf_float_4": null,
                   "udf_date_3": null,
                   "udf_date_4": null,
                   "udf_string_1": null,
                   "udf_string_2": null,
                   "udf_string_3": null,
                   "udf_string_4": null,
                   "udf_string_5": null,
                   "udf_string_6": null,
                   "udf_string_7": null,
                   "state": "Active",
                   "udf_string_8": null,
                   "type": "Personal",
                   "id": "827AEC3875474B99B7829FCA52D2E4F8",
                   "email": "brianakozior@gmail.com"
               }
           ],
           "category":
           {
               "name": "Contact Category",
               "id": "486B0C17A39E5F5339BD16B288AE12FE",
               "code": "Contact Category"
           }
       }
    }
               

GET contact_information/list

This method returns information related with contact information.  Multiple contact information can be returned by each call

Tip

Available from CRM.COM R5.0.0

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

id_number

(semi-optional)

String

The ID number of the contact information

passport_number 

(semi-optional)

String

The passport number of the contact information

social_security_number 

(semi-optional)

String

The social security number of the contact information

vat_registration_number

(semi-optional)

String

The registration number of the contact information

email_address

(semi-optional)

String

The email address of the contact information

Tip

Available from CRM.COM R13.0.0

phone_number

(semi-optional)

String

The phone number of the contact information

Tip

Available from CRM.COM R13.0.0

number_of_results

(optional)

Number

The number of results that can be retrieved through each call

Tip

Available from CRM.COM R13.0.0

offset

(optional)

Number

Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number

Tip

Available from CRM.COM R13.0.0

fields_set

(optional)

List of Strings, comma separated 

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Multiple semi-optional parameters can be specified in each call

Response Data

...

Examples

Expand
titleExample 1

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
    {
       "status":
       {
           "message": null,
           "description": null,
           "code": "OK"
       },
       "data":
       [
           {
               "udf_string_10": "userfield10",
               "organizational_unit": 0,
               "udf_float_1": 10,
               "udf_string_11": "userfield11",
               "udf_float_2": 12,
               "udf_string_12": "userfield12",
               "udf_float_3": 13,
               "udf_string_13": "userfield13",
               "udf_float_4": 14,
               "udf_string_14": "userfield14",
               "udf_float_5": 5,
               "udf_string_15": "userfield15",
               "udf_string_1": "userfield1",
               "name": "Maria Ioannou",
               "udf_string_16": "userfield16",
               "udf_float_6": 2,
               "udf_string_2": "userfield2",
               "udf_float_7": 1,
               "udf_string_3": "userfield3",
               "privacy_level":
               {
                   "number": null,
                   "hierarchy_level": 3,
                   "name": "Moderate",
                   "id": "9450216690684C416363B57DAD4596C3"
               },
               "company_name": null,
               "udf_float_8": 7,
               "udf_string_4": "userfield4",
               "udf_string_5": "userfield5",
               "udf_string_6": "userfield6",
               "udf_string_7": "userfield7",
               "udf_string_8": "userfield8",
               "udf_string_9": "userfield9",
               "last_name": "Ioannou",
               "id": "0514658236551391DE14490617FA49CA",
               "relation_set":
               [
               ],
               "log_information":
               {
                   "updated_date": "2014-10-24T09:17:07",
                   "created_by_unit":
                   {
                       "community_name": "Main Community",
                       "group_name": "Main Group",
                       "name": "Admin Unit",
                       "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                       "description": "r1",
                       "alternative_code": "MG"
                   },
                   "created_date": "2013-10-11T17:30:16",
                   "updated_by_unit":
                   {
                       "community_name": "Main Community",
                       "group_name": "Main Group",
                       "name": "Admin Unit",
                       "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                       "description": "r1",
                       "alternative_code": "MG"
                   },
                   "created_by_user":
                   {
                       "person_name": "MPAdministrator",
                       "username": "MPAdministrator",
                       "id": "1",
                       "email": "mp@ministrator.com"
                   },
                   "updated_by_user":
                   {
                       "person_name": "MPAdministrator",
                       "username": "MPAdministrator",
                       "id": "1",
                       "email": "mp@ministrator.com"
                   }
               },
               "life_cycle_state": "FINANCIAL",
               "first_name": "Maria",
               "type": "PERSON",
               "addresses_set":
               [
                   {
                       "care_of": "MML",
                       "street_number": "12",
                       "udf_string_10": null,
                       "udf_float_1": null,
                       "udf_string_11": null,
                       "street_name": "ilia papakiriakou",
                       "udf_float_2": null,
                       "udf_string_12": null,
                       "udf_float_3": null,
                       "udf_string_13": null,
                       "udf_float_4": null,
                       "udf_string_14": null,
                       "udf_string_15": null,
                       "po_box": "1212",
                       "udf_string_1": null,
                       "udf_string_16": null,
                       "udf_string_2": null,
                       "floor": 9,
                       "udf_string_3": null,
                       "area": "Makedonitisa",
                       "udf_string_4": null,
                       "district": "Nicosia",
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Inactive",
                       "udf_string_8": null,
                       "udf_string_9": null,
                       "country":
                       {
                           "name": "CYPRUS",
                           "id": "181"
                       },
                       "id": "2E7D50026366AF98CD006C5883E825DA",
                       "postal_code": "pc0001",
                       "udf_date_1": null,
                       "udf_date_2": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "po_box_postal_code": "1323",
                       "apartment_number": "91",
                       "town_city": "Lefkosia",
                       "type": "Home",
                       "municipality": "Nicosia"
                   },
                   {
                       "care_of": "MML",
                       "street_number": "23",
                       "udf_string_10": null,
                       "udf_float_1": null,
                       "udf_string_11": null,
                       "street_name": "Egnatias 102",
                       "udf_float_2": null,
                       "udf_string_12": null,
                       "udf_float_3": null,
                       "udf_string_13": null,
                       "udf_float_4": null,
                       "udf_string_14": null,
                       "udf_string_15": null,
                       "po_box": "986548",
                       "udf_string_1": null,
                       "udf_string_16": null,
                       "udf_string_2": null,
                       "floor": 2,
                       "udf_string_3": null,
                       "area": "Centre",
                       "udf_string_4": null,
                       "district": "Makedonia",
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Active",
                       "udf_string_8": null,
                       "udf_string_9": null,
                       "country":
                       {
                           "name": "GREECE",
                           "id": "209"
                       },
                       "id": "5FDA3D490F36322B44AB621BDE288ECC",
                       "postal_code": "7061",
                       "udf_date_1": null,
                       "udf_date_2": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "po_box_postal_code": "986548-1",
                       "apartment_number": "203",
                       "town_city": "Thessaloniki",
                       "type": "Home",
                       "municipality": "voria ellada"
                   },
                   {
                       "care_of": "MML",
                       "street_number": "12",
                       "udf_string_10": null,
                       "udf_float_1": null,
                       "udf_string_11": null,
                       "street_name": "Olimpiados",
                       "udf_float_2": null,
                       "udf_string_12": null,
                       "udf_float_3": null,
                       "udf_string_13": null,
                       "udf_float_4": null,
                       "udf_string_14": null,
                       "udf_string_15": null,
                       "po_box": "986547",
                       "udf_string_1": null,
                       "udf_string_16": null,
                       "udf_string_2": null,
                       "floor": 12,
                       "udf_string_3": null,
                       "area": "kamara",
                       "udf_string_4": null,
                       "district": "makedonia",
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Active",
                       "udf_string_8": null,
                       "udf_string_9": null,
                       "country":
                       {
                           "name": "GREECE",
                           "id": "209"
                       },
                       "id": "D6B0827D10A0043ADE7198F0EC6D2D11",
                       "postal_code": "7060",
                       "udf_date_1": null,
                       "udf_date_2": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "po_box_postal_code": "986547-1",
                       "apartment_number": "4",
                       "town_city": "thessaloniki",
                       "type": "Business",
                       "municipality": "voria ellada"
                   }
               ],
               "title": "Miss",
               "company_profile":
               {
                   "tax_reference_number": null,
                   "annual_turnover": null,
                   "number_of_employees": null,
                   "profile_year": null,
                   "established_date": null,
                   "industry_sector":
                   {
                       "name": "EDUCATION",
                       "id": "AF6E0855324153EAB8B582A277147BCE",
                       "alternative_code": "1"
                   },
                   "registered_in_country": null,
                   "vat_registration_number": null,
                   "industry":
                   {
                       "name": "Interior Design",
                       "id": "06B638258885DA26FA2BD40D9128D04E",
                       "code": "INTDS"
                   },
                   "vat_registration_date": null,
                   "vat_registered_by": null,
                   "registration_number": null
               },
               "udf_date_1": "2014-05-05T15:49:59",
               "phones_set":
               [
                   {
                       "notes": "Honduras",
                       "udf_float_1": null,
                       "udf_float_2": null,
                       "udf_date_1": null,
                       "udf_float_3": null,
                       "udf_date_2": null,
                       "number": "988321236448",
                       "udf_float_4": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "udf_string_1": null,
                       "udf_string_2": null,
                       "udf_string_3": null,
                       "udf_string_4": null,
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Active",
                       "udf_string_8": null,
                       "country":
                       {
                           "name": "HONDURAS",
                           "id": "225"
                       },
                       "full_number": "504988321236448",
                       "type": "Landline",
                       "id": "F8E6B7A8135CA81CCEC810643E137CF6",
                       "area_code": "504"
                   }
               ],
               "udf_date_2": "2014-05-05T14:49:59",
               "udf_date_3": "2014-05-05T16:49:59",
               "udf_date_4": "2014-05-05T17:49:59",
               "udf_date_5": "2014-05-05T18:49:59",
               "udf_date_6": "2014-05-05T01:49:59",
               "demographics":
               {
                   "gender": "FEMALE",
                   "passport_issued_by_country":
                   {
                       "name": "HONDURAS",
                       "id": "225"
                   },
                   "passport_number": "15420910",
                   "social_security_number": "15420920",
                   "country_of_residence":
                   {
                       "name": "HONDURAS",
                       "id": "225"
                   },
                   "industry_sector":
                   {
                       "name": "EDUCATION",
                       "id": "AF6E0855324153EAB8B582A277147BCE",
                       "alternative_code": "1"
                   },
                   "date_of_birth":
                   {
                       "month": 5,
                       "day": 1,
                       "year": 1928
                   },
                   "name_day":
                   {
                       "month": 1,
                       "day": 7
                   },
                   "id_number": "154209",
                   "id_issued_by_country":
                   {
                       "name": "HONDURAS",
                       "id": "225"
                   },
                   "industry":
                   {
                       "name": "Interior Design",
                       "id": "06B638258885DA26FA2BD40D9128D04E",
                       "code": "INTDS"
                   }
               },
               "udf_date_7": "2014-05-05T19:49:59",
               "udf_date_8": "2014-05-05T20:49:59",
               "owned_by_group":
               {
                   "community_name": "Main Community",
                   "name": "Nicosia Office",
                   "id": "68D54DA033606669621E3D2E4B355DA0",
                   "description": null,
                   "alternative_code": "NO"
               },
               "middle_name": "A.",
               "emails_set":
               [
                   {
                       "udf_float_1": null,
                       "udf_float_2": null,
                       "udf_date_1": null,
                       "udf_float_3": null,
                       "udf_date_2": null,
                       "udf_float_4": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "udf_string_1": null,
                       "udf_string_2": null,
                       "udf_string_3": null,
                       "udf_string_4": null,
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Active",
                       "udf_string_8": null,
                       "type": "Business",
                       "id": "FAD6C644E1AE8216B05A56BAFE40CEFF",
                       "email": "mariaioannou@crm.com"
                   },
                   {
                       "udf_float_1": null,
                       "udf_float_2": null,
                       "udf_date_1": null,
                       "udf_float_3": null,
                       "udf_date_2": null,
                       "udf_float_4": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "udf_string_1": null,
                       "udf_string_2": null,
                       "udf_string_3": null,
                       "udf_string_4": null,
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Active",
                       "udf_string_8": null,
                       "type": "Personal",
                       "id": "77BC050D87E7FCA0D2EED9A5B9C4DCCB",
                       "email": "mariaioannou@personalcrm.com"
                   }
               ],
               "category":
               {
                   "name": "Clients",
                   "id": "BF9E138C477E2450F2DB2C40CB5DF7FB",
                   "code": "CLS"
               }
           },
           {
               "udf_string_10": "userfield10",
               "organizational_unit": 0,
               "udf_float_1": 10,
               "udf_string_11": "userfield11",
               "udf_float_2": 12,
               "udf_string_12": "userfield12",
               "udf_float_3": 13,
               "udf_string_13": "userfield13",
               "udf_float_4": 14,
               "udf_string_14": "userfield14",
               "udf_float_5": 5,
               "udf_string_15": "userfield15",
               "udf_string_1": "userfield1",
               "name": "Marios Christodoulou",
               "udf_string_16": "userfield16",
               "udf_float_6": 2,
               "udf_string_2": "userfield2",
               "udf_float_7": 1,
               "udf_string_3": "userfield3",
               "privacy_level":
               {
                   "number": null,
                   "hierarchy_level": 1,
                   "name": "3",
                   "id": "0BA1A4672D1A071351BB1297A99F2915"
               },
               "company_name": null,
               "udf_float_8": 7,
               "udf_string_4": "userfield4",
               "udf_string_5": "userfield5",
               "udf_string_6": "userfield6",
               "udf_string_7": "userfield7",
               "udf_string_8": "userfield8",
               "udf_string_9": "userfield9",
               "last_name": "Christodoulou",
               "id": "4F9B9A0E0CCB894101AE977EDCFC7E18",
               "relation_set":
               [
               ],
               "log_information":
               {
                   "updated_date": "2014-10-24T13:25:21",
                   "created_by_unit":
                   {
                       "community_name": "Main Community",
                       "group_name": "Main Group",
                       "name": "Admin Unit",
                       "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                       "description": "r1",
                       "alternative_code": "MG"
                   },
                   "created_date": "2014-10-24T11:11:14",
                   "updated_by_unit":
                   {
                       "community_name": "Main Community",
                       "group_name": "Main Group",
                       "name": "Admin Unit",
                       "id": "48305F8849E3C18B227C5BE3A27BA6DF",
                       "description": "r1",
                       "alternative_code": "MG"
                   },
                   "created_by_user":
                   {
                       "person_name": "MPAdministrator",
                       "username": "MPAdministrator",
                       "id": "1",
                       "email": "mp@ministrator.com"
                   },
                   "updated_by_user":
                   {
                       "person_name": "MPAdministrator",
                       "username": "MPAdministrator",
                       "id": "1",
                       "email": "mp@ministrator.com"
                   }
               },
               "life_cycle_state": "MARKETING",
               "first_name": "Marios",
               "type": "PERSON",
               "addresses_set":
               [
                   {
                       "care_of": "MML",
                       "street_number": "23",
                       "udf_string_10": null,
                       "udf_float_1": null,
                       "udf_string_11": null,
                       "street_name": "Egnatias 102",
                       "udf_float_2": null,
                       "udf_string_12": null,
                       "udf_float_3": null,
                       "udf_string_13": null,
                       "udf_float_4": null,
                       "udf_string_14": null,
                       "udf_string_15": null,
                       "po_box": "986548",
                       "udf_string_1": null,
                       "udf_string_16": null,
                       "udf_string_2": null,
                       "floor": 2,
                       "udf_string_3": null,
                       "area": "Centre",
                       "udf_string_4": null,
                       "district": "Makedonia",
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Active",
                       "udf_string_8": null,
                       "udf_string_9": null,
                       "country":
                       {
                           "name": "UNITED KINGDOM",
                           "id": "126"
                       },
                       "id": "6CC99F6B9D87A44332E8A1789E2C2AC2",
                       "postal_code": "7061",
                       "udf_date_1": null,
                       "udf_date_2": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "po_box_postal_code": "986548-1",
                       "apartment_number": "203",
                       "town_city": "Thessaloniki",
                       "type": "Business",
                       "municipality": "voria ellada"
                   },
                   {
                       "care_of": "MML",
                       "street_number": "23",
                       "udf_string_10": null,
                       "udf_float_1": null,
                       "udf_string_11": null,
                       "street_name": "Egnatias 102",
                       "udf_float_2": null,
                       "udf_string_12": null,
                       "udf_float_3": null,
                       "udf_string_13": null,
                       "udf_float_4": null,
                       "udf_string_14": null,
                       "udf_string_15": null,
                       "po_box": "986548",
                       "udf_string_1": null,
                       "udf_string_16": null,
                       "udf_string_2": null,
                       "floor": 2,
                       "udf_string_3": null,
                       "area": "Centre",
                       "udf_string_4": null,
                       "district": "Makedonia",
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Active",
                       "udf_string_8": null,
                       "udf_string_9": null,
                       "country":
                       {
                           "name": "UNITED KINGDOM",
                           "id": "126"
                       },
                       "id": "3BC7A36F14234E81CD97BDF466F38FCE",
                       "postal_code": "7061",
                       "udf_date_1": null,
                       "udf_date_2": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "po_box_postal_code": "986548-1",
                       "apartment_number": "203",
                       "town_city": "Thessaloniki",
                       "type": "Home",
                       "municipality": "voria ellada"
                   }
               ],
               "title": "Sir",
               "company_profile":
               {
                   "tax_reference_number": null,
                   "annual_turnover": null,
                   "number_of_employees": null,
                   "profile_year": null,
                   "established_date": null,
                   "industry_sector": null,
                   "registered_in_country": null,
                   "vat_registration_number": null,
                   "industry":
                   {
                       "name": "Interior Design",
                       "id": "06B638258885DA26FA2BD40D9128D04E",
                       "code": "INTDS"
                   },
                   "vat_registration_date": null,
                   "vat_registered_by": null,
                   "registration_number": null
               },
               "udf_date_1": "2014-05-05T15:49:59",
               "phones_set":
               [
                   {
                       "notes": "Honduras",
                       "udf_float_1": null,
                       "udf_float_2": null,
                       "udf_date_1": null,
                       "udf_float_3": null,
                       "udf_date_2": null,
                       "number": "988321236448",
                       "udf_float_4": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "udf_string_1": null,
                       "udf_string_2": null,
                       "udf_string_3": null,
                       "udf_string_4": null,
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Active",
                       "udf_string_8": null,
                       "country":
                       {
                           "name": "UNITED KINGDOM",
                           "id": "126"
                       },
                       "full_number": "44988321236448",
                       "type": "Landline",
                       "id": "DBE65816407D8DF60C0E62BF87F07617",
                       "area_code": "44"
                   }
               ],
               "udf_date_2": "2014-05-05T14:49:59",
               "udf_date_3": "2014-05-05T16:49:59",
               "udf_date_4": "2014-05-05T17:49:59",
               "udf_date_5": "2014-05-05T18:49:59",
               "udf_date_6": "2014-05-05T01:49:59",
               "demographics":
               {
                   "gender": "MALE",
                   "passport_issued_by_country":
                   {
                       "name": "HONDURAS",
                       "id": "225"
                   },
                   "passport_number": "15420910",
                   "social_security_number": "15420920",
                   "country_of_residence":
                   {
                       "name": "UNITED KINGDOM",
                       "id": "126"
                   },
                   "industry_sector": null,
                   "date_of_birth":
                   {
                       "month": 5,
                       "day": 1,
                       "year": 1928
                   },
                   "name_day":
                   {
                       "month": 1,
                       "day": 7
                   },
                   "id_number": "154209",
                   "id_issued_by_country":
                   {
                       "name": "HONDURAS",
                       "id": "225"
                   },
                   "industry":
                   {
                       "name": "Interior Design",
                       "id": "06B638258885DA26FA2BD40D9128D04E",
                       "code": "INTDS"
                   }
               },
               "udf_date_7": "2014-05-05T19:49:59",
               "udf_date_8": "2014-05-05T20:49:59",
               "owned_by_group":
               {
                   "community_name": "Main Community",
                   "name": "Main Group",
                   "id": "84F33366CB592BAAE7E2044D93611C6A",
                   "description": "Main Group",
                   "alternative_code": "das"
               },
               "middle_name": "A.",
               "emails_set":
               [
                   {
                       "udf_float_1": 12,
                       "udf_float_2": 13,
                       "udf_date_1": "2014-09-12T09:44:20",
                       "udf_float_3": null,
                       "udf_date_2": null,
                       "udf_float_4": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "udf_string_1": "udf_string1",
                       "udf_string_2": "udf_string2",
                       "udf_string_3": "udf_string3",
                       "udf_string_4": "udf_string4",
                       "udf_string_5": "udf_string5",
                       "udf_string_6": "udf_string6",
                       "udf_string_7": "udf_string7",
                       "state": "Active",
                       "udf_string_8": "udf_string8",
                       "type": "Personal",
                       "id": "B4211DE145CD3AA03AAB93C61C9070AA",
                       "email": "mariaioannou@personalcrm.com"
                   },
                   {
                       "udf_float_1": null,
                       "udf_float_2": null,
                       "udf_date_1": null,
                       "udf_float_3": null,
                       "udf_date_2": null,
                       "udf_float_4": null,
                       "udf_date_3": null,
                       "udf_date_4": null,
                       "udf_string_1": null,
                       "udf_string_2": null,
                       "udf_string_3": null,
                       "udf_string_4": null,
                       "udf_string_5": null,
                       "udf_string_6": null,
                       "udf_string_7": null,
                       "state": "Active",
                       "udf_string_8": null,
                       "type": "Business",
                       "id": "42FB2FDF0CE0C2A9EC1CD173FCAEFB89",
                       "email": "mariaioannou@crm.com"
                   }
               ],
               "category":
               {
                   "name": "Clients",
                   "id": "BF9E138C477E2450F2DB2C40CB5DF7FB",
                   "code": "CLS"
               }
           }
       ]
    } 

POST contact_information/create

This method creates a contact information.  Single contact information can be created by each call. All addresses, phones and emails which are added on the contact information are added as active

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

type

(mandatory)

...

String

...

The type of the contact information which can be PERSON or COMPANY

...

title

(optional)

...

String

...

The title of the contact information. Applicable only if the type is PERSON

...

first_name

(mandatory on conditions)

...

String

...

The first name of the contact information. Applicable and mandatory only if the type is PERSON

...

middle_name

(optional)

...

String

...

The middle name of the contact information. Applicable only if the type is PERSON

...

last_name

(mandatory on conditions)

...

String

...

The last name of the contact information. Applicable and mandatory only if the type is PERSON

...

company_name

(mandatory on conditions)

...

The company name of the contact information. Applicable and mandatory only if the type is COMPANY

...

preferred_language

(optional)

...

The contact information's preferred language. The avialable options are:

  • ARA
  • DAN
  • ENG
  • EST
  • FIN
  • FRA
  • DEU
  • ELL
  • JPN
  • VIE
  • MAL
  • IND
  • TAI
  • LAV
  • LIT
  • NNO
  • POL
  • POR
  • RUS
  • SPA
  • SWE
  • UKR
  • CMN
  • TGL
  • HIN
  • CUSTOM1
  • CUSTOM2
  • CUSTOM3
  • CUSTOM4
  • CUSTOM5
  • CUSTOM6
  • CUSTOM7
  • CUSTOM8
Tip

Available from CRM.COM R12.0.0

...

category_identifier

(optional)

...

Identifier  

The identifier of the contact category that will be associate with the contact information. The allowed contact category identifier fields are the following:

...

owned_by_group_identifier

(optional)

...

The group owning the contact information. The allowed group identifier fields are the following:

...

privacy_level_identifier

(optional)

...

The privacy level of the contact information. The allowed privacy level identifier fields are the following:

...

notes

(optional)

...

send_direct_marketing_material

(optional)

...

Boolean

 

...

The Contact Information's authorization setting for Direct Marketing

Tip

Available from CRM.COM R9.0.0

...

send_affiliate_marketing_material

(optional)

...

Boolean

...

The Contact Information's authorization setting for Affiliate Marketing

Tip

Available from CRM.COM R9.0.0

...

udf_string_1

(optional)

...

User Defined Field of type String

...

udf_string_2

(optional)

...

User Defined Field of type String

...

udf_string_3

(optional)

...

User Defined Field of type String

...

udf_string_4

(optional)

...

User Defined Field of type String

...

udf_string_5

(optional)

...

User Defined Field of type String

...

udf_string_6

(optional)

...

User Defined Field of type String

...

udf_string_7

(optional)

...

User Defined Field of type String

...

udf_string_8

(optional)

...

User Defined Field of type String

...

udf_string_9

(optional)

...

User Defined Field of type String

...

udf_string_10

(optional)

...

User Defined Field of type String

...

udf_string_11

(optional)

...

User Defined Field of type String

...

udf_string_12

(optional)

...

User Defined Field of type String

...

udf_string_13

(optional)

...

User Defined Field of type String

...

udf_string_14

(optional)

...

User Defined Field of type String

...

udf_string_15

(optional)

...

User Defined Field of type String

...

udf_string_16

(optional)

...

User Defined Field of type String

...

udf_float_1

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_2

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_3

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_4

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_5

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_6

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_7

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_8

(optional)

...

Float

...

User Defined Field of type Float

...

udf_date_1

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_2

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_3

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_4

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_5

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_6

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_7

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_8

(optional)

...

Date

...

User Defined Field of type Date

...

demographics

(optional)

...

Demographics object

...

The demographics of the contact information. Applicable only if the type is PERSON

 

...

company_profile

(optional)

...

Company profile object

...

The company profile of the contact information. Applicable only if the type is COMPANY

 

...

address_set

(optional)

...

The addresses of the contact information

 

...

phone_set

(optional)

...

The phone of the contact information

 

...

email_set

(optional)

...

The email of the contact information

 

...

relation_set

(optional)

...

Contact Information business and personal relation object

 

...

The business and personal relations of the contact information

Tip

Available from CRM.COM R5.0.0

...

fields_set

(optional)

...

List of Strings, comma separated

 

...

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Tip

Available from CRM.COM R10.0.0

...

 

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

...

Examples

Expand
titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
 "token":"FA32A9008D7348F5984DEA452FA65B5A", 
"type":"PERSON",
  "title":"Sir",
  "first_name":"Louis",
  "middle_name":"Aloz",
  "last_name":"Kozior",
  "category_identifier":{"name":"Contact Category"},
  "owned_by_group_identifier":{"name":"Main Group"},
  "privacy_level_identifier":{"number":"8"},
  "notes": "Family",
  "udf_string_1":"udf string 1",
   "udf_string_2":"udf string 2",
   "udf_string_3":"udf string 3",
   "udf_string_4":"udf string 4",
   "udf_string_5":"udf string 5",
   "udf_string_6":"udf string 6",
   "udf_string_7":"udf string 7",
   "udf_string_8":"udf string 8",
   "udf_string_8":"udf string 9",
   "udf_string_8":"udf string 10",
   "udf_string_8":"udf string 11",
   "udf_string_8":"udf string 12",
   "udf_string_8":"udf string 13",
   "udf_string_8":"udf string 14",
   "udf_string_8":"udf string 15",
   "udf_string_8":"udf string 16",
   "udf_float_1":10,
   "udf_float_2":20,
   "udf_float_3":30,
   "udf_float_4":40,
   "udf_float_5":50,
   "udf_float_6":60,
   "udf_float_7":70,
   "udf_float_8":80,
   "udf_date_1":"2014-05-05T15:49:59",
   "udf_date_2":"2014-06-05T15:49:59",
   "udf_date_3":"2014-07-05T15:49:59",
   "udf_date_4":"2014-08-05T15:49:59",
   "demographics":
   {
     "gender":"FEMALE",
     "id_number":"AB112234",
     "passport_number":"CD112234",
     "social_security_number":"EF112234",
     "country_of_residence_identifier":{"name":"CYPRUS"},
     "id_issued_by_country_identifier":{"name":"CYPRUS"},
     "passport_issued_by_country_identifier":{"name":"GREECE"},
     "industry_identifier":{"name":"Marketing"},
     "industry_sector_identifier":{"name":"FOREX"},
     "date_of_birth":{
                       "day":12,
                       "month":5,
                       "year":1981                     
                  },
     "name_day":     {
                       "day":18,
                       "month":8                     
                   }
   },
    "address_set": [
                     {
                       "type": "HOME",
                       "postal_code": "3020",
                       "street_name": "Ilia Papakiriakou",
                       "street_number" : "8",
                       "floor":2,
                       "apartment_number":"202",
                       "area": "Plati",
                       "town_city":"Aglanjia",
                       "district":"Nicosia",
                       "municipality":"Aglanjia",
                       "country_identifier":{	"two_character_code": "CY" },
                       "po_box":"70022",
                       "po_box_postal_code":"AG70022",
                       "care_of":"Maria Kyriacou",
                       "notes":"To be reviewed",
                       "udf_string_1":"udf string 1",
            "udf_string_2":"udf string 2",
            "udf_string_3":"udf string 3",
               "udf_string_4":"udf string 4",
              "udf_string_5":"udf string 5",
              "udf_string_6":"udf string 6",
              "udf_string_7":"udf string 7",
              "udf_string_8":"udf string 8",
             "udf_string_8":"udf string 9",
             "udf_string_8":"udf string 10",
              "udf_string_8":"udf string 11",
              "udf_string_8":"udf string 12",
              "udf_string_8":"udf string 13",
              "udf_string_8":"udf string 14",
              "udf_string_8":"udf string 15",
              "udf_string_8":"udf string 16",
              "udf_float_1":10,
              "udf_float_2":20,
              "udf_float_3":30,
              "udf_float_4":40,
              "udf_float_5":50,
              "udf_float_6":60,
              "udf_float_7":70,
              "udf_float_8":80,
             "udf_date_1":"2014-05-05T15:49:59",
             "udf_date_2":"2014-06-05T15:49:59",
             "udf_date_3":"2014-07-05T15:49:59",
             "udf_date_4":"2014-08-05T15:49:59"
             }
          ],
   "phone_set": [
                 {
                    "type": "LANDLINE",
                    "number":"22114455"
                 }
               ],
  "email_set": [
                 {
                    "type": "PERSONAL",
                    "email_address": "brianakozior@gmail.com"
                  }
                ],
   "relation_set": [
                  {
                "type":"FAMILY_MEMBER",
                "contact_information_identifier":{"id_number" : "142536"}
              }
                ]
}

Response:

 

Code Block
languagejs
{
       "status":
       {
           "message": null,
           "description": null,
           "code": "OK"
       },
       "data":
       {
           "last_name": "Kozior",
           "life_cycle_state": "MARKETING",
           "middle_name": "Aloz",
           "company_profile": null,
           "title": "Sir",
           "type": "PERSON",
           "first_name": "Louis",
           "name": "Louis Kozior",
           "id": "1F1D2D0DFD164BFA801BE87CA9E33915",
           "company_name": null,
           "demographics":
           {
               "gender": "FEMALE",
               "passport_issued_by_country":
               {
                   "three_character_code": "GRC",
                   "two_character_code": "GR",
                   "name": "GREECE",
                   "id": "209",
                   "alternative_code": null
               },
               "passport_number": "CD112234",
               "social_security_number": "EF112234",
               "country_of_residence":
               {
                   "three_character_code": "CYP",
                   "two_character_code": "CY",
                   "name": "CYPRUS",
                   "id": "181",
                   "alternative_code": null
               },
               "industry_sector":
               {
                   "name": "FOREX",
                   "id": "D8ACF18AB4494AD33738A9F4C94E6995",
                   "alternative_code": "FRX"
               },
               "date_of_birth":
               {
                   "month": 5,
                   "day": 12,
                   "year": 1981
               },
               "name_day":
               {
                   "month": 8,
                   "day": 18
               },
               "id_number": "AB112234",
               "id_issued_by_country":
               {
                   "three_character_code": "CYP",
                   "two_character_code": "CY",
                   "name": "CYPRUS",
                   "id": "181",
                   "alternative_code": null
               },
               "industry":
               {
                   "name": "Marketing",
                   "id": "31BC2070C79EAE5455BFAD41599C5190",
                   "code": "MK"
               }
           }
       }
}

 

 

...

titleExample 2

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
 "token":"656AE15BA46552027451AD4C319B8B92",  
"type":"COMPANY",
 "company_name":"Koziors",
  "category_identifier":{"name":"Company Category"},
  "owned_by_group_identifier":{"name":"Main Group"},
  "privacy_level_identifier":{"number":"8"},
  "notes": "Company",
  "udf_string_1":"udf string 1",
   "udf_string_2":"udf string 2",
   "udf_string_3":"udf string 3",
   "udf_string_4":"udf string 4",
   "udf_string_5":"udf string 5",
   "udf_string_6":"udf string 6",
   "udf_string_7":"udf string 7",
   "udf_string_8":"udf string 8",
   "udf_string_8":"udf string 9",
   "udf_string_8":"udf string 10",
   "udf_string_8":"udf string 11",
   "udf_string_8":"udf string 12",
   "udf_string_8":"udf string 13",
   "udf_string_8":"udf string 14",
   "udf_string_8":"udf string 15",
   "udf_string_8":"udf string 16",
   "udf_float_1":10,
   "udf_float_2":20,
   "udf_float_3":30,
   "udf_float_4":40,
   "udf_float_5":50,
   "udf_float_6":60,
   "udf_float_7":70,
   "udf_float_8":80,
   "udf_date_1":"2014-05-05T15:49:59",
   "udf_date_2":"2014-06-05T15:49:59",
   "udf_date_3":"2014-07-05T15:49:59",
   "udf_date_4":"2014-08-05T15:49:59",
   "company_profile":
   {
    "profile_year" : 1999,
    "annual_turnover":1999,
    "established_date" :"1999-05-05T15:49:59",
    "number_of_employees" : 4,
    "registration_number" : "KZ126591",
    "vat_registration_number" : "126591",
    "vat_registered_by" : "Manager",
    "vat_registration_date":"2000-05-05T15:49:59",
    "tax_reference_number":"126591",
    "registered_in_country_identifier" : {"name":"CYPRUS"},
    "industry_identifier":{"name":"Interior Design"},
    "industry_sector_identifier":{"name":"GOVERNMENTAL"}
  },
    "address_set": [
                     {
                       "type": "HOME",
                       "postal_code": "3020",
                       "street_name": "Ilia Papakiriakou",
                       "street_number" : "8",
                       "floor":2,
                       "apartment_number":"202",
                       "area": "Plati",
                       "town_city":"Aglanjia",
                       "district":"Nicosia",
                       "municipality":"Aglanjia",
                       "country_identifier":{"name":"CYPRUS"},
                       "po_box":"70022",
                       "po_box_postal_code":"AG70022",
                       "care_of":"Maria Kyriacou",
                       "notes":"To be reviewed",
                       "udf_string_1":"udf string 1",
            "udf_string_2":"udf string 2",
            "udf_string_3":"udf string 3",
               "udf_string_4":"udf string 4",
              "udf_string_5":"udf string 5",
              "udf_string_6":"udf string 6",
              "udf_string_7":"udf string 7",
              "udf_string_8":"udf string 8",
             "udf_string_8":"udf string 9",
             "udf_string_8":"udf string 10",
              "udf_string_8":"udf string 11",
              "udf_string_8":"udf string 12",
              "udf_string_8":"udf string 13",
              "udf_string_8":"udf string 14",
              "udf_string_8":"udf string 15",
              "udf_string_8":"udf string 16",
              "udf_float_1":10,
              "udf_float_2":20,
              "udf_float_3":30,
              "udf_float_4":40,
              "udf_float_5":50,
              "udf_float_6":60,
              "udf_float_7":70,
              "udf_float_8":80,
             "udf_date_1":"2014-05-05T15:49:59",
             "udf_date_2":"2014-06-05T15:49:59",
             "udf_date_3":"2014-07-05T15:49:59",
             "udf_date_4":"2014-08-05T15:49:59"
             }
          ],
   "phone_set": [
                 {
                    "type": "LANDLINE",
                    "number":"22114455"
                 }
               ],
  "email_set": [
                 {
                    "type": "PERSONAL",
                    "email_address": "brianakozior@gmail.com"
                  }
                ],
   "relation_set": [
                  {
                "type":"PARTNER_COMPANY",
                "contact_information_identifier":{"id_number" : "AB112233"}
              }
                ]
}

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
    "status":
    {
        "message": null,
        "description": null,
        "code": "OK"
    },
    "data":
    {
        "last_name": null,
        "life_cycle_state": "MARKETING",
        "middle_name": null,
        "company_profile":
        {
            "tax_reference_number": "126591",
            "annual_turnover": 1999,
            "number_of_employees": 4,
            "profile_year": 1999,
            "established_date": "1999-05-05T15:49:59",
            "industry_sector":
            {
                "name": "GOVERNMENTAL",
                "id": "A9BDEBD4D8FAEDB0BACE40C041156D12",
                "alternative_code": "GOV"
            },
            "registered_in_country":
            {
                "name": "CYPRUS",
                "id": "181"
            },
            "vat_registration_number": "126591",
            "industry":
            {
                "name": "Interior Design",
                "id": "06B638258885DA26FA2BD40D9128D04E",
                "code": "INTDS"
            },
            "vat_registration_date": "2000-05-05T15:49:59",
            "vat_registered_by": "Manager",
            "registration_number": "KZ126591"
        },
        "title": null,
        "type": "COMPANY",
        "first_name": null,
        "name": "Koziors",
        "id": "5B1E5A7D3D1F41E159C58870367D1A76",
        "company_name": "Koziors",
        "demographics": null
    }
}

...

titleExample 3

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
  "token":"{{token}}",
  "type":"PERSON",
  "title":"Mr",
  "first_name":"Joanna",
  "middle_name":"Lewis",
  "last_name":"Adams",
  "category_identifier":{"name":"Contact Category"},
  "owned_by_group_identifier":{"name":"Main Group"},
  "privacy_level_identifier":{"number":"8"},
  "notes": "Family",
   "demographics":
   {
     "gender":"FEMALE",
     "id_number":"AB112234",
     "passport_number":"CD112234",
     "social_security_number":"EF112234",
     "country_of_residence_identifier":{"name":"CYPRUS"},
     "id_issued_by_country_identifier":{"name":"CYPRUS"},
     "passport_issued_by_country_identifier":{"name":"GREECE"},
     "industry_identifier":{"name":"Industry2"},
     "industry_sector_identifier":{"name":"FOREX"},
     "date_of_birth":{
                       "day":12,
                       "month":5,
                       "year":1981                    
                  },
     "name_day":     {
                       "day":18,
                       "month":8                    
                   }
   },
    "address_set": [
                     {
                       "type": "HOME",
                       "postal_code": "3020",
                       "street_name": "Ilia Papakiriakou",
                       "street_number" : "8",
                       "floor":2,
                       "apartment_number":"202",
                       "area": "Plati",
                       "town_city":"Aglanjia",
                       "district":"Nicosia",
                       "municipality":"Aglanjia",
                       "country_identifier":{ "two_character_code": "CY" },
                       "po_box":"70022",
                       "po_box_postal_code":"AG70022",
                       "care_of":"Maria Kyriacou",
                       "notes":"To be reviewed"
                       
             }
          ],
   "phone_set": [
                 {
                    "type": "LANDLINE",
                    "number":"22114455"
                 }
               ],
  "email_set": [
                 {
                    "type": "PERSONAL",
                    "email_address": "brianakozior@gmail.com"
                  }
                ],
  "fields_set":"first_name,last_name,demographics,email_set"
}

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
    {
    "status": {
        "message": "",
        "description": "",
        "code": "OK"
    },
    "data": {
        "last_name": "Adams",
        "first_name": "Joanna",
        "demographics": {
            "gender": "FEMALE",
            "passport_issued_by_country": {
                "three_character_code": "GRC",
                "two_character_code": "GR",
                "id": "209",
                "name": "GREECE",
                "alternative_code": null
            },
            "social_security_number": "EF112234",
            "passport_number": "CD112234",
            "industry_sector": {
                "id": "D8ACF18AB4494AD33738A9F4C94E6995",
                "name": "FOREX",
                "alternative_code": "FRX"
            },
            "country_of_residence": {
                "three_character_code": "CYP",
                "two_character_code": "CY",
                "id": "181",
                "name": "CYPRUS",
                "alternative_code": null
            },
            "name_day": {
                "month": 8,
                "day": 18
            },
            "date_of_birth": {
                "month": 5,
                "day": 12,
                "year": 1981
            },
            "id_number": "AB112234",
            "industry": {
                "id": "39E3A8C68925F4216D79C7EEBD71D4B4",
                "name": "Industry2",
                "code": "Ind2"
            },
            "id_issued_by_country": {
                "three_character_code": "CYP",
                "two_character_code": "CY",
                "id": "181",
                "name": "CYPRUS",
                "alternative_code": null
            }
        }
    }
}
    

POST contact_information/update

This method update a contact information.  Single contact information can be updated by each call. Fields which are not specified are not updated at all. Fields which are specified as null will be set as null.  All addresses, phones and emails which are added on the contact information are added as active

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

contact_information_identifier

(mandatory)

...

The identifier of the contact information to be updated. The allowed contact information identifier fields are the following:

...

title

(optional)

...

String

...

The title of the contact information. Applicable only if the type is PERSON

...

first_name

(mandatory on conditions)

...

String

...

The first name of the contact information. Applicable and mandatory only if the type is PERSON

...

middle_name

(optional)

...

String

...

The middle name of the contact information. Applicable only if the type is PERSON

...

last_name

(mandatory on conditions)

...

String

...

The last name of the contact information. Applicable and mandatory only if the type is PERSON

...

company_name

(mandatory on conditions)

...

The company name of the contact information. Applicable and mandatory only if the type is COMPANY

...

category_identifier

(optional)

...

Identifier  

The identifier of the contact category that will be associate with the contact information. The allowed contact category identifier fields are the following:

...

owned_by_group_identifier

(optional)

...

The group owning the contact information. The allowed group identifier fields are the following:

...

privacy_level_identifier

(optional)

...

The privacy level of the contact information. The allowed privacy level identifier fields are the following:

...

notes

(optional)

...

send_direct_marketing_material

(optional)

...

Boolean

 

...

The Contact Information's authorization setting for Direct Marketing

Tip

Available from CRM.COM R9.0.0

...

send_affiliate_marketing_material

(optional)

...

Boolean

 

...

The Contact Information's authorization setting for Affiliate Marketing

Tip

Available from CRM.COM R9.0.0

...

preferred_language

(optional)

 

...

The Contact Information's preferred language. The available options are:

  • ARA
  • DAN
  • ENG
  • EST
  • FIN
  • FRA
  • DEU
  • ELL
  • JPN
  • VIE
  • MAL
  • IND
  • TAI
  • LAV
  • LIT
  • NNO
  • POL
  • POR
  • RUS
  • SPA
  • SWE
  • UKR
  • CMN
  • TGL
  • HIN
  • CUSTOM1
  • CUSTOM2
  • CUSTOM3
  • CUSTOM4
  • CUSTOM5
  • CUSTOM6
  • CUSTOM7
  • CUSTOM8
Tip

Available from CRM.COM R12.0.0

...

udf_string_1

(optional)

...

User Defined Field of type String

...

udf_string_2

(optional)

...

User Defined Field of type String

...

udf_string_3

(optional)

...

User Defined Field of type String

...

udf_string_4

(optional)

...

User Defined Field of type String

...

udf_string_5

(optional)

...

User Defined Field of type String

...

udf_string_6

(optional)

...

User Defined Field of type String

...

udf_string_7

(optional)

...

User Defined Field of type String

...

udf_string_8

(optional)

...

User Defined Field of type String

...

udf_string_9

(optional)

...

User Defined Field of type String

...

udf_string_10

(optional)

...

User Defined Field of type String

...

udf_string_11

(optional)

...

User Defined Field of type String

...

udf_string_12

(optional)

...

User Defined Field of type String

...

udf_string_13

(optional)

...

User Defined Field of type String

...

udf_string_14

(optional)

...

User Defined Field of type String

...

udf_string_15

(optional)

...

User Defined Field of type String

...

udf_string_16

(optional)

...

User Defined Field of type String

...

udf_float_1

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_2

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_3

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_4

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_5

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_6

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_7

(optional)

...

Float

...

User Defined Field of type Float

...

udf_float_8

(optional)

...

Float

...

User Defined Field of type Float

...

udf_date_1

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_2

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_3

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_4

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_5

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_6

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_7

(optional)

...

Date

...

User Defined Field of type Date

...

udf_date_8

(optional)

...

Date

...

User Defined Field of type Date

...

demographics

(optional)

...

Demographics object

...

The demographics of the contact information. Applicable only if the type is PERSON

 

...

company_profile

(optional)

...

Company profile object

...

The company profile of the contact information. Applicable only if the type is COMPANY

 

...

address_set

(optional)

...

The addresses of the contact information

...

phone_set

(optional)

...

The phone of the contact information

...

email_set

(optional)

...

The email of the contact information

...

relation_set

(optional)

 

...

Contact Information business and personal relation object

 

The business and personal relations of the contact information

...

Tip

Available from CRM.COM R5.0.0

fields_set

(optional)

...

 A list of fields that should be included in the results. If  not specified then all the available fields will be returned

...

Available from CRM.COM R10.0.0

...

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

...

Examples

...

titleExample 1

HTTP Method: POST

 

Request:

Body:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
"token":"{{token}}",
"contact_information_identifier":{"id":"3459F30F71E7477495DF3AA3D278CC7D"},
"type ":"PERSON",
"address_set":
    [{
            "action":"add",
            "type":"BUSINESS",
            "postal_code":"7060",
            "street_name":"Latisa",
            "street_number":"12",
            "floor":2,
            "apartment_number":"204",
            "area":"Latsia",
            "town_city":"Nicosia",
            "district":"Nicosia",
            "municipality":"NA Nicosia",
            "country_identifier":{"id":"181"},
            "po_box":"986547",
            "po_box_postal_code":"986547-1"
        }],
"phone_set":
    [{
    "action": "update",
    "phone_identifier":{"type":"LANDLINE"},
    "number":"99849996",
    "country_identifier":{"id":"180"}
    }],
"send_direct_marketing_material":0,
"send_affiliate_marketing_material":0
}

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
  "data": {
    "notes": null,
    "log_information": {
      "created_by_unit": {
        "alternative_code": "adminunit",
        "group_name": "Main Group",
        "community_name": "Community",
        "name": "Admin Unit",
        "description": "admin unit",
        "id": "1"
      },
      "updated_by_unit": {
        "alternative_code": "adminunit",
        "group_name": "Main Group",
        "community_name": "Community",
        "name": "Admin Unit",
        "description": "admin unit",
        "id": "1"
      },
      "created_date": "2016-08-10T09:18:32",
      "updated_date": "2016-08-10T09:32:08",
      "updated_by_user": {
        "person_name": "CRM COM",
        "id": "1",
        "username": "MPAdministrator"
      },
      "created_by_user": {
        "person_name": "MPAdministrator",
        "id": "1",
        "email": "dev@crm.com",
        "username": "MPAdministrator"
      }
    },
    "type": "PERSON",
    "id": "3459F30F71E7477495DF3AA3D278CC7D",
    "organizational_unit": 0,
    "udf_string_2": null,
    "udf_string_3": null,
    "udf_string_4": null,
    "udf_string_5": null,
    "privacy_level": null,
    "udf_string_1": null,
    "life_cycle_state": "MARKETING",
    "phones_set": [
      {
        "udf_string_2": null,
        "udf_string_3": null,
        "country": {
          "alternative_code": "CUB",
          "three_character_code": null,
          "name": "CUBA",
          "id": "180",
          "two_character_code": null
        },
        "udf_string_4": null,
        "notes": null,
        "udf_string_5": null,
        "area_code": "53",
        "udf_string_1": null,
        "type": "LANDLINE",
        "udf_date_2": null,
        "udf_date_1": null,
        "udf_date_4": null,
        "full_number": "005399849996",
        "udf_date_3": null,
        "number": "99849996",
        "udf_float_3": null,
        "udf_float_4": null,
        "id": "49D7EC23AE92455492A7F9D5BC2EB887",
        "state": "Active",
        "udf_string_6": null,
        "udf_float_1": null,
        "udf_string_7": null,
        "udf_float_2": null,
        "udf_string_8": null
      }
    ],
    "company_name": null,
    "name": "Ellen Leon",
    "udf_string_6": null,
    "udf_string_7": null,
    "udf_string_8": null,
    "udf_string_9": null,
    "relation_set": [],
    "addresses_set": [
      {
        "apartment_number": "2",
        "care_of": null,
        "country": {
          "alternative_code": "CYP",
          "three_character_code": "CYP",
          "name": "CYPRUS",
          "id": "181",
          "two_character_code": "CY"
        },
        "municipality": null,
        "type": "HOME",
        "udf_date_2": null,
        "udf_date_1": null,
        "street_name": "Piccadilly Avenue",
        "udf_date_4": null,
        "udf_date_3": null,
        "udf_float_3": null,
        "udf_float_4": null,
        "po_box_postal_code": null,
        "udf_string_15": null,
        "udf_string_16": null,
        "udf_string_13": null,
        "udf_string_14": null,
        "udf_string_11": null,
        "udf_string_12": null,
        "id": "548EDA85AED54AD1A64D362C28046157",
        "state": "Active",
        "udf_string_10": null,
        "floor": 5,
        "udf_float_1": null,
        "udf_float_2": null,
        "area": null,
        "udf_string_2": null,
        "udf_string_3": null,
        "udf_string_4": null,
        "udf_string_5": null,
        "udf_string_1": null,
        "po_box": null,
        "town_city": "Oxford",
        "district": null,
        "street_number": "21",
        "postal_code": "bas321",
        "udf_string_6": null,
        "udf_string_7": null,
        "udf_string_8": null,
        "udf_string_9": null
      },
      {
        "apartment_number": "204",
        "care_of": null,
        "country": {
          "alternative_code": "CYP",
          "three_character_code": "CYP",
          "name": "CYPRUS",
          "id": "181",
          "two_character_code": "CY"
        },
        "municipality": "NA Nicosia",
        "type": "BUSINESS",
        "udf_date_2": null,
        "udf_date_1": null,
        "street_name": "Latisa",
        "udf_date_4": null,
        "udf_date_3": null,
        "udf_float_3": null,
        "udf_float_4": null,
        "po_box_postal_code": "986547-1",
        "udf_string_15": null,
        "udf_string_16": null,
        "udf_string_13": null,
        "udf_string_14": null,
        "udf_string_11": null,
        "udf_string_12": null,
        "id": "52012022FE1E464D935DFC2585987216",
        "state": "Active",
        "udf_string_10": null,
        "floor": 2,
        "udf_float_1": null,
        "udf_float_2": null,
        "area": "Latsia",
        "udf_string_2": null,
        "udf_string_3": null,
        "udf_string_4": null,
        "udf_string_5": null,
        "udf_string_1": null,
        "po_box": "986547",
        "town_city": "Nicosia",
        "district": "Nicosia",
        "street_number": "12",
        "postal_code": "7060",
        "udf_string_6": null,
        "udf_string_7": null,
        "udf_string_8": null,
        "udf_string_9": null
      }
    ],
    "owned_by_group": {
      "alternative_code": "MG",
      "community_name": "Community",
      "name": "Main Group",
      "description": "Main Group",
      "id": "1"
    },
    "udf_date_6": null,
    "udf_date_5": null,
    "udf_date_8": null,
    "udf_date_7": null,
    "title": "Miss",
    "udf_date_2": null,
    "udf_date_1": null,
    "udf_date_4": null,
    "udf_date_3": null,
    "emails_set": [],
    "udf_float_5": null,
    "udf_float_6": null,
    "udf_float_3": null,
    "udf_float_4": null,
    "company_profile": {
      "tax_reference_number": null,
      "registered_in_country": null,
      "number_of_employees": null,
      "annual_turnover": null,
      "profile_year": null,
      "registration_number": null,
      "vat_registration_number": null,
      "industry_sector": null,
      "industry": null,
      "established_date": null,
      "vat_registered_by": null,
      "vat_registration_date": null
    },
    "udf_string_15": null,
    "udf_string_16": null,
    "udf_string_13": null,
    "udf_float_7": null,
    "udf_string_14": null,
    "udf_float_8": null,
    "udf_string_11": null,
    "udf_string_12": null,
    "udf_string_10": null,
    "udf_float_1": null,
    "first_name": "Ellen",
    "udf_float_2": null,
    "last_name": "Leon",
    "middle_name": "Arthour",
    "authorization_settings": {
      "direct_marketing_setting_updated_by_user": {
        "person_name": "CRM COM",
        "id": "1",
        "username": "MPAdministrator"
      },
      "affiliate_marketing_setting_updated_by_user": {
        "person_name": "CRM COM",
        "id": "1",
        "username": "MPAdministrator"
      },
      "affiliate_marketing_setting_updated_date": "2016-08-10T09:32:08",
      "send_affiliate_marketing_material": false,
      "send_direct_marketing_material": false,
      "direct_marketing_setting_updated_date": "2016-08-10T09:32:08"
    },
    "category": null,
    "demographics": {
      "name_day": {
        "month": null,
        "day": null
      },
      "id_number": "ADASF125546665",
      "gender": "FEMALE",
      "country_of_residence": {
        "alternative_code": "CYP",
        "three_character_code": "CYP",
        "name": "CYPRUS",
        "id": "181",
        "two_character_code": "CY"
      },
      "date_of_birth": {
        "month": null,
        "year": null,
        "day": null
      },
      "industry_sector": null,
      "passport_number": "DDFF12336544",
      "industry": null,
      "social_security_number": "54561465146",
      "id_issued_by_country": {
        "alternative_code": "GBR",
        "three_character_code": null,
        "name": "UNITED KINGDOM",
        "id": "126",
        "two_character_code": null
      },
      "passport_issued_by_country": {
        "alternative_code": "GBR",
        "three_character_code": null,
        "name": "UNITED KINGDOM",
        "id": "126",
        "two_character_code": null
      }
    }
  },
  "status": {
    "code": "OK",
    "description": "",
    "message": ""
  }
}

GET contact_information/profile_photo/view

Tip

Available from CRM.COM R11.0.0

This method returns the profile photo information related with a contact information

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

(mandatory)

...

Identifier  

The identifier of the contact information that should be retrieved. The allowed contact information identifier fields are the following:

...

fields_set
(optional)

...

List of Strings, comma separated 

...

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

  • It is mandatory to specify at least one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

...

Examples

Expand
titleExample 1

HTTP Method: GET

 

Request:

Response:

Code Block
themeConfluence
languagejs
linenumberstrue
 {
  "data": {
    "file_name": "217F456047A749728A263BEC2A472003_key_contacts-profilephoto_images.jpg",
    "file_content_url": "/crm/ImageDownloadServlet?id=217F456047A749728A263BEC2A472003",
    "file_mime_type": "image/jpeg"
  },
  "status": {
    "code": "OK",
    "description": "",
    "message": ""
  }
}

 

Note:

To retrieve or display the actual image you need to construct the following URL

Code Block
languagexml
{{server}}{{file_content_url}}&token={{token}}  

for example

Code Block
languagexml
https://r11qa.crm.com/crm/ImageDownloadServlet?id=217F456047A749728A263BEC2A472003&token=B18ECEE5918442A0A29B7C1B2D0A4260

POST contact_information/profile_photo/add

Tip

Available from CRM.COM R11.0.0

This method is used to add a profile photo on an existing contact information. This Web API method requires a multipart/form-data post, as defined in RFC 1867. There are many libraries available that can be used in order to submit multipart/form-data posts (for example MultipartEntity in Java). A single contact information can be updated through each call

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

(mandatory)

...

Identifier  

The identifier of the contact information that should be updated. The allowed contact information identifier fields are the following:

...

file

(semi-optional)

...

fields_set
(optional)

...

List of Strings, comma separated 

...

A list of fields that should be included in the results. If not specified then all the available fields will be returned

Restrictions

  • It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.

Response Data

...

Examples

Expand
titleExample 1

cURL Example:

Code Block
languagetext
linenumberstrue
curl --request POST \
  --url https://r11qa.crm.com/crmapi/rest/v2/contact_information/profile_photo/add \
  --header 'content-type: multipart/form-data; boundary=---011000010111000001101001' \
  --form 'file=@[object Object]' \
  --form contact_information_identifier=id=18686813304341ECAFC8175A85594C9B \
  --form 'token=C9464BFEC45F49989AAB17E1C54FA4D0' 

 

PHP Example:

Code Block
languagephp
linenumberstrue
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://r11qa.crm.com/crmapi/rest/v2/contact_information/profile_photo/add",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"[object Object]\"\r\nContent-Type: false\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"contact_information_identifier\"\r\n\r\nid=18686813304341ECAFC8175A85594C9B\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"token\"\r\n\r\nC9464BFEC45F49989AAB17E1C54FA4D0\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => array(
    "content-type: multipart/form-data; boundary=---011000010111000001101001"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
} 

POST contact_information/profile_photo/remove

Tip

Available from CRM.COM R11.0.0

This method is used to remove the profile photo from a specific contact information.  A single contact information can be updated through this method

Resource URL

Parameters

...

Name

...

Type

...

Description

...

token

...

String

...

The token retrieved from the login method

...

(mandatory)

...

Identifier  

The identifier of the contact information that should be updated. The allowed contact information identifier fields are the following:

...

Response Data

Not applicable

Examples

HTTP Method: POST

 

Request:

Body:

Expand
titleExample 1
Code Block
themeConfluence
languagejs
linenumberstrue
 {
"token":"{{token}}",
"contact_information_identifier":{"id":"0D93E390FA354A17A5148945A15A191D"}
} 

 

Response:

Not applicable

  Panel
nameblue

Child pages (Children Display)
excerpttrue