SMS Configuration

Before Getting Started

⚠️

Important: Make sure you are collecting SMS consent from your end users before sending any messages.

If your Klaviyo account does not allow you to collect SMS consent through Klaviyo forms, please use a Springbig form instead.

Collecting proper consent from your customers is required to ensure compliance before sending SMS communications.



What You'll Learn

  • Trigger SMS messages directly from Klaviyo Flows
  • Incorporate pre-approved images and message templates
  • Add clickable links with tracking and optional follow-up webhooks
  • Securely configure API credentials with Springbig

Why is this required

  • This setup allows you to send personalized, compliant SMS messages through Klaviyo using your approved Springbig assets.

🛠 Setup SMS Message Flow in Klaviyo

Step 1: Access Flows

  1. From your Klaviyo dashboard, click Flows in the left-hand menu.
  2. Click Create Flow in the top-right corner.
  3. Click Build your own

Step 2: Name your Flow

  1. Enter a descriptive flow name, for example:

    {{Your List Name}} + Springbig Webhook
📘

Use a name that reflects the specific Klaviyo list and purpose, so it’s clear this flow syncs that list to Springbig.


Step 3: Add a Trigger

  1. Choose from the list of triggers or design your own
  2. For this guide we will be using the example of 'Customer added to list'.

Step 4: Add a Webhook Action

  1. In the flow builder, drag and drop a Webhook under the trigger.

  2. Give the webhook a descriptive name, such as:

    Springbig SMS Trigger
📘

Use a name that makes it easy to identify this webhook as your SMS message trigger.


Step 3: Configure Webhook Details

  1. Destination URL:

    https://production.api.springbig.technology/general/v1/message_template_logs
  2. Headers:

    • auth-token: Provided by your Springbig Account Manager
    • x-api-key: Provided by your Springbig Account Manager
    • Content-Type: application/json
  3. JSON Body: Paste the following payload and adjust values as required:

{
  "message_template_id": 123,
  "phone_number": "{{ person.phone_number | default:'' }}",
  "redirect_url": "https://website.com",
  "webhook_url": "https://webhook.com",
  "label": "campaign name",
  "merchant_location_id": 1234,
  "template_image_id": 456
}
🚧

Required fields: message_template_id, phone_number, and template_image_id (if including an image).
Your Account Manager will provide the correct IDs.


Step 4: Save & Activate

  1. Click Update Action Statuses (top-right).
  2. Set Action Status to Live.
  3. Click Save (bottom-left).
✅

Your SMS Flow is now live! When a customer enters this Klaviyo Flow, a personalized SMS will be triggered via Springbig.

📘 Parameters Reference

FieldTypeRequiredDescription
message_template_idinteger✅ YesID of the approved SMS template (provided by your Account Manager)
phone_numberstring✅ YesCustomer’s phone number from Klaviyo ({{ person.phone_number }})
template_image_idintegerRecommendedRequired if including an approved image (provided by your Account Manager)
labelstringRecommendedName of the campaign. This will be used to group messages into one campaign for analytics and reporting
redirect_urlstringRecommendedOptional clickable link included in the SMS
webhook_urlstringNoOptional URL to capture link click events
merchant_location_idintegerNoMerchant location ID if relevant

Did this page help you?