i4w_date
Usage
Using a "Send Http post to another server" action, this module provides a mechanism to create and/or modify a date/time value and store the outcome in an Keap contact record.
Both regular and custom fields can be used. This module can be called through a 'Send an http post…' following a web or order form.
This module can be called through a 'Send an http post…' as part of a trigger process, legacy action set or campaign builder sequence.
Parameters
| Parameter | Value | Description |
|---|---|---|
| i4w_date | YOUR_SECURITY_KEY | Authenticates the request using the security key. Required: Yes. |
| source | fieldname | Defines the name of the contact field to use as the basis date. Required: No, defaults to "now". |
| target | fieldname | Defines the name of the contact field to be updated with the value of the outcome of the operation. Required: Yes. |
| operation | string | Any string that the PHP function strtotime() would be able to resolve. Please note that spaces must be entered as %20 and any "+" or "-" must be spelled out as "plus" or "minus", respectively. Required: No. |
| format | string | Provides the string based on PHP date() to use in formatting the date/time outcome. Required: No, default to seconds. |
Example
- Basic
- Plus Month
- With Format
Add 2 weeks to current date and store in target field.
https://yoursite.com/?i4w_date=YOUR_SECURITY_KEY&target=_nextmeeting&operation=plus%202%20weeks
Add 1 month to current date.
https://yoursite.com/?i4w_date=YOUR_SECURITY_KEY&target=_nextmeeting&operation=plus%201%20month
Add 30 days to source field and store with specific format.
https://yoursite.com/?i4w_date=YOUR_SECURITY_KEY&source=_lastmeeting&target=_nextmeeting&operation=plus%2030%20days&format=Y-m-d%20H:i:s
Notes
In all examples provided, YOUR_SECURITY_KEY stand for the security key defined under plugin options. These are used to authenticate the request.
Format shortcuts:
| Shortcut | Format |
|---|---|
| date | Ymd |
| datetime | Ymd\TH:i:s |
| timestamp | Y-m-d H:i:s |
The new "Campaign Builder" HTTP POST do not automatically send the contact record data for processing. Individual value pairs must now be specified. In this case, the required value pair is either of the following:
| Parameter | Keap Merge Field |
|---|---|
| Id | ~Contact.Id~ |
| contactId | ~Contact.Id~ |
| ContactId | ~Contact.Id~ |
| Contact0Id | ~Contact.Id~ |