Webhooks: Unique contact identifiers added to payload and new payload transformation template introduced

  • Updated

What’s Changing

1. The webhook payload for events triggered from an Automated Program step and Form Submissions will include the unique IDs to accurately identify the right contact to find in the third party.

  • RecID and ListID for form submission webhooks: Example form submission webhook payload with the listId and recId fields highlighted.

    The screenshot below shows an example form submission webhook payload with the new listId and recId fields highlighted.

  • RecID and ExternalID for contacts completing Webhook AP step:Example Automated Program webhook payload with the recId and externalId fields highlighted for a contact completing a webhook step.

    The screenshot below shows an example Automated Program webhook payload with the new recId and externalId fields highlighted for a contact completing a webhook step.

2. Payload Transformation Template added for PostCard Mania.

When setting up a webhook that is triggered from Automated Programs, a template is available that maps Act-On's payload to the required JSON formatting from PostCard Mania, a Postcard Printing and Direct Mail service:

The New Endpoint setup screen with the Transformation template tab selected, offering templates for PostGrid, IgnitePOST, and PostCardMania - Place Letter Order.

The screenshot below shows the New Endpoint setup screen with the Transformation template tab selected, offering templates for PostGrid, IgnitePOST, and PostCardMania - Place Letter Order.

The transformation script for the PostCardMania template, mapping webhook payload fields like contact name and address into the recipient and return address format.

The screenshot below shows the transformation script for the PostCardMania template, mapping webhook payload fields like contact name and address into the recipient and return address format PostCardMania expects.

When

January 25, 2024.

Customer Impact

  • Customers have more data available to properly identify the right contact to update or personalize in the third-party system.
  • A direct integration is now available with PostCard Mania for those customers who wish to personalize communications to qualified leads or new members with direct mail.
Only customers using All Contacts will benefit from this update. If you don't see All Contacts, please fill out the form using this link to request this feature activation.

Was this article helpful?

Have more questions? Submit a request