Send SMS

POST https://api.brevo.com/v3/transactionalSMS/sms
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "type": "transactional",
  "unicodeEnabled": false,
  "sender": "TajoLoyalty",
  "recipient": "+1234567890",
  "content": "Hi John! You've earned 150 points from your recent purchase. Your total: 1,250 points. Redeem at tajo.com/rewards"
}

{
  "reference": "sms_abc123",
  "messageId": "msg_def456"
}

{
  "type": "transactional",
  "sender": "TajoRewards",
  "recipient": "+1234567890",
  "content": "🎉 Great news {{contact.FIRSTNAME}}! You earned {{params.pointsEarned}} points from order #{{params.orderNumber}}. Total: {{params.totalPoints}} points. Shop more at {{params.storeUrl}}",
  "params": {
    "pointsEarned": "200",
    "orderNumber": "ORD-2024-001",
    "totalPoints": "1,450",
    "storeUrl": "shop.tajo.com"
  }
}

{
  "content": "🌟 Congratulations {{contact.FIRSTNAME}}! You've been upgraded to {{params.newTier}} status! Enjoy {{params.benefits}}. Your new point balance: {{params.totalPoints}}",
  "params": {
    "newTier": "Gold",
    "benefits": "free shipping & exclusive offers",
    "totalPoints": "2,500"
  }
}

{
  "content": "✅ Reward redeemed! {{params.rewardName}} - {{params.pointsUsed}} points used. Coupon: {{params.couponCode}} (expires {{params.expiryDate}}). Remaining: {{params.remainingPoints}} points",
  "params": {
    "rewardName": "20% Off",
    "pointsUsed": "1000",
    "couponCode": "SAVE20NOW",
    "expiryDate": "Mar 15",
    "remainingPoints": "450"
  }
}

{
  "content": "📦 Your order #{{params.orderNumber}} has {{params.status}}! {{params.details}} Track: {{params.trackingUrl}}",
  "params": {
    "orderNumber": "ORD-2024-001",
    "status": "shipped",
    "details": "Arriving in 2-3 business days",
    "trackingUrl": "track.tajo.com/ORD-2024-001"
  }
}

{
  "type": "marketing",
  "sender": "TajoBday",
  "recipient": "+1234567890",
  "content": "🎂 Happy Birthday {{contact.FIRSTNAME}}! Here's a special gift: {{params.birthdayBonus}} bonus points + {{params.discountCode}} for {{params.discountAmount}} off! Valid until {{params.expiryDate}}",
  "params": {
    "birthdayBonus": "500",
    "discountCode": "BIRTHDAY25",
    "discountAmount": "25%",
    "expiryDate": "end of month"
  }
}

{
  "content": "🛒 Hi {{contact.FIRSTNAME}}, you left {{params.itemCount}} items in your cart worth {{params.cartValue}}. Complete your purchase and earn {{params.potentialPoints}} points! Continue: {{params.cartUrl}}",
  "params": {
    "itemCount": "3",
    "cartValue": "$299.97",
    "potentialPoints": "300",
    "cartUrl": "tajo.com/cart"
  }
}

{
  "content": "⚡ {{contact.FIRSTNAME}}, FLASH SALE: {{params.saleDetails}}! {{params.loyaltyTier}} members get {{params.bonusPoints}} bonus points! Shop now: {{params.saleUrl}} ({{params.timeLeft}} left)",
  "params": {
    "saleDetails": "50% off electronics",
    "loyaltyTier": "Gold",
    "bonusPoints": "double",
    "saleUrl": "tajo.com/flash",
    "timeLeft": "6 hours"
  }
}

{
  "type": "transactional",
  "templateId": 123,
  "params": {
    "customerName": "John Doe",
    "pointsBalance": "2,350",
    "nextReward": "Free shipping at 2,500 points"
  }
}

{
  "type": "transactional",
  "sender": "TajoRemind",
  "recipient": "+1234567890",
  "content": "⏰ Reminder: Your {{params.pointsExpiring}} points expire in {{params.daysLeft}} days! Use them at tajo.com/rewards",
  "scheduledAt": "2024-01-30T09:00:00Z",
  "params": {
    "pointsExpiring": "500",
    "daysLeft": "7"
  }
}

{
  "type": "transactional",
  "unicodeEnabled": true,
  "content": "🎊 ¡Felicidades {{contact.FIRSTNAME}}! Has ganado {{params.points}} puntos 💎",
  "params": {
    "points": "150"
  }
}

{
  "type": "marketing",
  "content": "{{#if contact.LOYALTY_TIER == 'Platinum'}}💎 VIP Alert: Early access to our sale + triple points!{{else}}🌟 Loyalty member: Get double points on your next purchase!{{/if}}",
  "webUrl": "https://tajo.com/sale"
}

{
  "content": "📍 {{contact.FIRSTNAME}}, there's a Tajo store near you! Visit {{params.nearestStore}} and show this text for {{params.inStoreBonus}} bonus points!",
  "params": {
    "nearestStore": "123 Main St, NYC",
    "inStoreBonus": "100"
  }
}

{
  "type": "transactional",
  "content": "Welcome to Tajo SMS alerts! Reply YES to confirm you want loyalty updates and exclusive offers. Reply STOP to opt out anytime. Msg & data rates may apply."
}

{
  "type": "transactional",
  "content": "You've been unsubscribed from Tajo SMS alerts. You'll still receive important order updates. To rejoin, text START. Questions? Contact [email protected]"
}

{
  "code": "invalid_recipient",
  "message": "Phone number format invalid",
  "details": {
    "recipient": "123-456-7890",
    "expectedFormat": "+1234567890"
  }
}

{
  "code": "message_too_long",
  "message": "SMS content exceeds character limit",
  "details": {
    "length": 180,
    "limit": 160,
    "segments": 2
  }
}

{
  "content": "Hi {{contact.FIRSTNAME}}! +{{params.points}}pts from order #{{params.orderNum}}. Total: {{params.total}}pts. tajo.com/rewards",
  "estimatedSegments": 1,
  "characterCount": 89
}

{
  "recipients": [
    {
      "phone": "+1234567890",
      "params": { "name": "John", "points": "150" }
    },
    {
      "phone": "+1234567891",
      "params": { "name": "Jane", "points": "200" }
    }
  ],
  "content": "Hi {{params.name}}! You earned {{params.points}} points!"
}