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

Add 2 weeks to current date and store in target field.

URL

https://yoursite.com/?i4w_date=YOUR_SECURITY_KEY&target=_nextmeeting&operation=plus%202%20weeks

Plus Month

Add 1 month to current date.

URL

https://yoursite.com/?i4w_date=YOUR_SECURITY_KEY&target=_nextmeeting&operation=plus%201%20month

With Format

Add 30 days to source field and store with specific format.

URL

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~