Web Form Post API (Contacts)

This application programming interface describes the html markup for a valid form post transmission to the SalesOptima system. You must have a valid account in good standing to use this API.

Caution: Do not attempt to use this API if you are not familiar with HTML and have not been properly training by a SalesOptima representative. If you misuse this API, your account may be locked and fees may apply.

Form Attribute	Value
Action	https://post.salesoptima.com/wcmpost.aspx
Test Action	https://post.salesoptima.com/apipostcheck.aspx
Method	Post

Note: The Request ID below refers to the variables within the post that the API expects and will process accordingly.

Request ID

Example

Contact Field/Mapping Notes

Important: The following fields are mandatory and should be added to your page as hidden fields

LinkCode

This is the code that identifies which Web Form to post data against.
Mandatory Hidden Field

RedirectURL

http://www.yourcompany.com

This is the URL that will be used to redirect the browser once the form has been submitted.
Mandatory Hidden Field

txtContactSettings

Mandatory Hidden Field
0=Duplicate Check (Default Action)
	Performs a duplicate check using the txtEmail, txtEmail2, and txtEmail3 fields. a) If a duplicate contact is detected, that contact will be updated. (Note: see txtContactOverWrite for rules on how data will be populated in duplicate contact.) b) If no duplicate contact is found, a new contact will be created. (Note: see txtContactOverWrite for rules on how data will be populated in new contact.)
1=Always Create New Contact
	Creates a new contact. (Note: see txtContactOverWrite for rules on how data will be populated in new contact.)
2=Duplicate Check (Override Security Settings)
	Performs the same duplicate check as 0 (see above) except your company's security settings are ignored. By default, the security model in place for your account will govern how the API searches your database to determine duplicates. By using this variable, you can instruct the API to ignore your security model and search your company's entire database. This is especially helpful when one web form will be shared by all users (i.e. Unsubscribe form).

txtContactOverWrite

Mandatory Hidden Field
0=Only Overwrite if blank (Default Action)
	All data fields present in post will populate their respective contact fields within SalesOptima only if the field is blank or empty.
1=Always Overwrite
	All data fields present in post will populate their respective contact fields within SalesOptima.
2=Ignore
	All data fields present in post will be ignored.
3 = Always Overwrite (unless form field is empty)
	All NON-EMPTY data fields present in post will populate their respective contact fields within SalesOptima.

All of the following fields are optional.

txtContactID

1406044

System Contact ID
Used For Duplicate Detection

txtFirstName

Joe

First Name

txtLastName

Sample

Last Name

txtSalutation

Mr.

Salutation

txtTitle

Sales Manager

Title

txtCompanyName

Sample Corp

Company (Company Module Settings Addendum - How do I create a company record?)

txtAdd1

123 Sample Drive

Address 1

txtAdd2

Suite 1500

Address 2

txtAdd3

Attention: Joe

Address 3

txtCity

SamplesVille

City

txtState

State

txtZip

62154

Zip

txtCountry

USA

Country

txtCustom1

PO Box 5433

Custom Text Field 1

txtCustom2

Custom Text Field 2

txtCustom3

Custom Text Field 3

txtCustom4

Sampleville

Custom Text Field 4

txtCustom5

Custom Text Field 5

txtCustom6

64125-5433

Custom Text Field 6

txtCustom7

USA

Custom Text Field 7

txtCustom8

2 bedroom

Custom Text Field 8

txtCustom9

2 bathroom

Custom Text Field 9

txtCheck1

TRUE

Custom Checkbox 1
True/False or 1/0

txtCheck2

FALSE

Custom Checkbox 2
True/False or 1/0

txtPhone

1235551212

Business Phone

txtHomePhone

1235551213

Home Phone

txtMobile

1235551214

Mobile

txtOtherPhone

1235551215

Other Phone

txtFax

1235551216

Fax

txtOtherFax

1235551217

Other Fax

txtEmail

joe@samplecorp.com

Primary Email
Used For Duplicate Detection

txtEmail2

joe@hotmail.com

Email 2

txtEmail3

joe@gmail.com

Email 3

txtWebSite

www.samplecorp.com

WebSite

txtForceOwner

VR90001

CLP User Code (CLP User Code Values Can Be Found Here)
Used to Change Owner of Contact

txtCommentsTitle

Additional Information:

Prefix to Comments

txtComments

I love bunnies.

Comments

The following Note fields will be compiled into a single contact history entry. Each title/note combination must have a number associated with it between 1 and 100.Use with caution: The amount of data gathered can grow very quickly for each contact because usually these are textarea fields

txtNoteTypeCode

1234

Note Type Dropdown
must be a valid Note Type code

txtNote1Title

What is your favorite color?

Question/Comment attached to txtNote1
usually a hidden field

txtNote1

Red