Assign an Important Date type to a contact via an http form post, for example recording that a contact's wedding anniversary is 06/14/2012.
Important Dates are typed, workflow-driven anniversary dates managed under Settings; they are distinct from the Special Events functions (AddContactSpecialEvent / GetContactSpecialEvents).
Use GetImportantDateTypes to look up the importantdateid values available for this account.
The next run date is always calculated by us from the event date and the date type's timing; it cannot be supplied.
| Field | Max Length | Required | Notes |
|---|---|---|---|
| response_type | false | Default results will be returned in XML. Set this field value to json to return results in JSON format | |
| accountid | true | Must be numeric. Account ID for this account. Found in Settings > API Settings or for White Label CRM in the Admin control panel | |
| apikey | true | API Key for this account. Found in Settings > API Settings or for White Label CRM in the Admin control panel | |
| identifymethod | 1 | true | Values: 1: By contactid (It's recommended that you use this method and store our contactid in your system) 2: By primary email on file. If there are multiple matches for the email address, we will choose the first one (by add date) 3: By email or other email on file. If there are multiple matches for the email address, we will choose the first one (by add date) |
| identifyvalue | 75 | true | Value changes based on identifymethod. Must be integer if contactid, otherwise must be an email address on file |
| importantdateid | conditional | Must be numeric. The Important Date type to assign, from GetImportantDateTypes. Required unless typename is supplied. If both are supplied, importantdateid is used. The date type must be active | |
| typename | 200 | conditional | The name of the Important Date type to assign, for example Anniversary. Not case sensitive. Used only when importantdateid is not supplied. Must match exactly one active date type on the account, otherwise an error is returned |
| eventdate | 10 | true | The actual anniversary or event date, in MM/DD/YYYY format. A 4 digit year is required. The year must be between 1900 and two years from now |
| notes | 500 | false | Notes for this date on this contact. Longer values are truncated to 500 characters |