Webhook Campaign Builder – Customer Guide

Tall Bob’s Webhook Campaign Builder lets you easily integrate with platforms like Klaviyo and DotDigital by generating a JSON payload that can be copied directly into your webhook configuration. Whatever you create in the Message tab is automatically converted into a webhook-ready payload

You can access the page via Distribution → Webhooks or directly from this link: Webhook Campaign Builder.

Fields and Options

Here’s a breakdown of the fields you’ll see in the builder:

1. Personalisation Type
    Choose the platform you are using – either Klaviyo (default) or DotDigital. Your selection determines which personalisation fields are available and also defines how the recipient data (the ‘to’ field) is structured in the JSON payload.
2. Sender ID
    Select your sender ID. This can be a long code or an alphanumeric sender ID, depending on your use case.
3. Message Builder
    Use this section to craft your message. You can:
   • Insert emojis
   • Add personalisation fields
   • Include external links
   • Add an opt-out link
     

     
     

     The builder only supports standard personalisation fields. If you need custom personalisations, you’ll need to handle that directly in your integration platform (Klaviyo or DotDigital).

         
4. Shorten URL
    Enable this if your message contains an external link. The URL will be shortened and branded either with your custom domain (if configured) or with Tall Bob’s default domain.
5. Campaign Reference
    Enter a campaign reference for easy tracking. This value will:
   • Appear in Tall Bob’s campaign reference reports which will make it easy for user to track the data
   • If you are using Klaviyo, this value will help identify campaigns in your Klaviyo attribution dashboard

Webhook Settings Tab

Once you have set up your message, click Next to go to the Webhook Settings tab. Here, you will find:

• Your message content has been automatically converted into a JSON payload
• Additional fields required for webhook configuration

Simply copy and paste these values into your webhook setup in your integration platform. Please refer to the image below for an example of webhook settings based on the message content shown in the previous screenshot.

Authorization & Credentials

The builder also provides a way to quickly generate or fetch API credentials for webhook authorization:

• Click Fetch Credentials to open the side pane.
• If credentials already exist, you can copy them for use in your integration.
• If no credentials exist, click Generate Credentials to create new ones.

Example of an Account with existing credentials

Example of an Account with no credentials

Any credentials generated here will also be available under your account in the Tall Bob API Credentials page.