Overview
Adds a contact to the database via an http form post. A successful post will return a success message and the contactid for the new contact.
Post Url
https://hyperdrivepro.morethanrewards.com/api/2/AddContact.aspx
- SSL is required
Form Fields
| Field | Max Length* | Required | Notes |
| response_type | Yes | Set this field value to json to return results in JSON format | |
| accountid | Yes | Must be numeric. Account ID for this account. | |
| apikey | Yes | API Key for this account. | |
| teammemberid | No | Must be numeric. Team Member ID. Defaults to 0 (Account Owner). If a team member is selected that does not “own” a database, the new contact will be put into the database that the user shares. | |
| firstname | 50 | Yes | Database requires both first and last name |
| lastname | 50 | Yes | Database requires both first and last name |
| birthday | 10 | No | Birthday year is optional. Use only formats MM/DD or MM/DD/YYYY. Zero pad leading digits, so month and day are always 2 digits. January 5th is 01/05. |
| otherfirstname | 50 | No | |
| otherlastname | 50 | No | |
| otherbirthday | 10 | No | Birthday year is optional. Use only formats MM/DD or MM/DD/YYYY. Zero pad leading digits, so month and day are always 2 digits. January 5th is 01/05. |
| company | 50 | No | |
| address | 50 | No | |
| city | 50 | No | |
| state | 20 | No | Recommended that this be the 2 digit state code for US addresses |
| postalcode | 20 | No | |
| phone1 | 20 | No | Will automatically be formatted to (xxx) xxx-xxxx |
| phone1note | 20 | No | Recommended that description is used if known (work, home, mobile, etc…) |
| phone2 | 20 | No | Will automatically be formatted to (xxx) xxx-xxxx |
| phone2note | 20 | No | |
| phone3 | 20 | No | Will automatically be formatted to (xxx) xxx-xxxx |
| phone3note | 20 | No | |
| phone4 | 20 | No | Will automatically be formatted to (xxx) xxx-xxxx |
| phone4note | 20 | No | |
| fax | 20 | No | Will automatically be formatted to (xxx) xxx-xxxx |
| 75 | No | ||
| otheremail | 75 | No | |
| custom1 | 50 | No | Recommended that you only use custom fields when user’s exact custom field mapping is known |
| … | … | … | Custom 1 through 20 |
| custom20 | 50 | No | |
| memo | 50 | No | Brief memo for contact. This is not a note, but a brief memo that shows up on the contact’s page. Recommended less than 100 characters. |
| category | 50 | No | Must match the name of an existing Category exactly. Any mismatch will result in the category not being assigned. |
| category2 | 50 | No | Must match the name of an existing Category2 exactly. Any mismatch will result in the category2 not being assigned. (This is the customizable category) |
| source | 50 | No | Must match the name of an existing Source exactly. Any mismatch will result in the source not being assigned. |
| othersystemid | 32 | No | For tracking the ID of this contact in another system |
| addednote | No | When a contact is added via the API, a note is added to the contact record. The default is “Contact Added via API”. You can override the default note with this field. |
* An error will not result if Max Length is exceeded. Data will be trimmed to this length.
Sample Results
Success Message
<?xml version="1.0"?>
<results>
<message>Success</message>
<contactid>15631</contactid>
</results>Sample Failure Message
<?xml version="1.0"?>
<results>
<error>Authentication failed</error>
</results>
