Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 2020.1

Table of Contents
outlinetrue
stylenone

...

Field

Required

Data Type

Options

Default

Notes

department

noInteger

Department RECID that the Contact is assigned to.

customer_number

no*Integer

Customer Number assigned to the Contact. Conditionally Required if Contact is a CUSTOMER type

first_name

yesString

Contact's First Name.
last_nameyesString

Contact's Last Name.

contact_directory

yesIntegerNo = 0, Yes = 1
Is this Contact in the Directory?
contact_typesyesString

CONTACT_TYPE Lists 

Toggle cloak

Cloak

Insert excerpt
API
API
nopaneltrue



What Type(s) of Contact is this? Example: "USER,CUSTOMER"
statusyesInteger

STATUS_TYPE Lists 

Toggle cloak

Cloak

Insert excerpt
API
API
nopaneltrue



Stats of the Contact (Active/Inactive).
typenoStringEMAIL, ADDRESS, PHONE, REMARKS, UDFS
What type of Contact information is being provided?
email_directoryyesIntegerNo = 0, Yes = 1
Should this Email show in the Directory.
emailyesString

New Primary Email for the Contact.

address_directory

noIntegerNo = 0, Yes = 1
Is this Address in the Directory?
address_typenostring

ADDRESS_TYPE Lists 

Toggle cloak

Cloak

Insert excerpt
API
API
nopaneltrue



What Type of Address is it?
street_addressno*String

First Line of the Address.

*If any Address fields are sent, all become Required

address2noString

Second Line of the Address.
cityno*String

City the Address is in.

*If any Address fields are sent, all become Required

stateno*String

State the Address is in. Use standard 2 Letter Abbreviation.

*If any Address fields are sent, all become Required

zip_codeno*Integer

5 digit Postal Code assigned to the Address.

*If any Address fields are sent, all become Required

phone_directoryyesIntegerNo = 0, Yes = 1
Should this Phone Number show in the Directory.
phone_primaryyesIntegerNo = 0, Yes = 1
Is this the Primary Phone Number?
phone_typeyesString

PHONE_TYPE Lists 

Toggle cloak

Cloak

Insert excerpt
API
API
nopaneltrue



What Type of Phone Number is this?
phone_numberyesInteger

Phone Number for the Contact.

...

Key

Value

Content-Type

application/json

Pcr-Html-Encoded

TRUE

Body:

Key

Value

type

EMAIL

email

help@pcr.com

email_directory0
contact_Directory1
first_namePCR
last_nameSysAdmin
contact_typesUSER
status1
contact_recid1

...

Key

Value

Content-Type

application/json

Pcr-Html-Encoded

TRUE

Body:

Key

Value

type

ADDRESS

address_directory

0

address_typeWarehouse
street_address1313 Mockingbird Lane
cityMockingbird Heights
stateCA
zip_code55555
contact_Directory1
first_namePCR
last_nameSysAdmin
contact_typesUSER
status1
contact_recid1

...

Key

Value

Content-Type

application/json

Pcr-Html-Encoded

TRUE

Body:

Key

Value

type

PHONE

phone_directory

0

phone_primary0
phone_typeWork
phone_number5558675309
contact_Directory1
first_namePCR
last_nameSysAdmin
contact_typesUSER
status1
contact_recid1

...

Cloak

If the request is successful, the RECID of the Contact is returned as follows:

Code Block
languagephp
linenumberstrue
{
    <status>success</status>
    <page>1</page>
    <count>1</count>
    <total_count>1</total_count>
    <contact>199017</contact>
}

Remarks

Remarks can be added to Contacts.

  • Requires "type = REMARKS"

Available Fields

Field

Required

Data Type

Options

Default

Notes

contact_recid

yes

Integer



RECID of the Contact

remarks

yes

String



The remark to add to the Contact

Call:

Code Block
languagephp
POST DOMAIN/KEY/contact.json

Headers:

Key

Value

Content-Type

application/json

Pcr-Html-Encoded

TRUE

Body:

Key

Value

typeREMARKS

contact_recid

1

remarks

This is the Demo Account

Results

If the request is successful, the RECID of the Remark record will be returned as follows:

Toggle cloak

Cloak


Code Block
languagexml
linenumberstrue
{
    <status>success</status>
    <page>1</page>
    <count>1</count>
    <total_count>1</total_count>
    <contact>199017</contact>
}

Contacts Remarks Tab ExampleImage Added

Contact UDFs

User Defined Fields can be easily set for a Contact. To get a list of available UDFs for each Contact, visit Lists.

  • Requires "type = UDFS"

Available Fields

Field

Required

Data Type

Options

Default

Notes

contact_recid

Yes

Integer



The RECID of the Contact that the UDF is for

udf_UDF-RECIDYes*Integer

UDF-RECID is the RECID of the UDF to assign the value to. Example: udf_684=value
  • See Note Below
udf_UDF-IDENTIFIERYes*Mixed

IDENTIFIER is the unique Identifier of the UDF to assign the value to. Example: udf_LEGACYNUM=value
  • See Note Below
  • udf_UDF-RECID and udf_UDF-IDENTIFIER are Conditionally Required. The use of one is Required, but not both.

Call:

Code Block
languagephp
POST DOMAIN/KEY/contacts.json

Headers:

Key

Value

Content-Type

application/json

Pcr-Html-Encoded

TRUE

Body:

Key

Value

typeUDFS

contact_recid

1

udf_UDF-RECID1

0000

udf_UDF-IDENTIFIER2test

Results

If the request is successful, the RECID(s) of the new Contact UDF records will be returned in the same order as provided:

Toggle cloak

Cloak


Code Block
languagexml
linenumberstrue
{
    <status>success</status>
    <page>1</page>
    <count>1</count>
    <total_count>1</total_count>
    <contact>199017</contact>
}

Manage Contacts User Defined Fields Tab ExampleImage Added

Locating Contact Data

To locate contact data navigate to Main > People > Workers / Contacts, to view the Workers / Contacts Grid.

...