engineer-rest-api

What problem does it solve?

Provides a clear, implementable pattern for building, sending, scheduling, and debugging Braze REST API messages so backend teams can reliably deliver email, SMS, reminders, and product recommendations without guessing payload shapes or error handling.

Core Features & Use Cases

• Endpoint selection & payload construction: Maps channel-specific message objects to the correct /messages/send and scheduling endpoints with required fields.
• Authentication and rate management: Shows how to include workspace REST API keys, handle 429 rate limits with exponential backoff, and batch recipients for high-volume sends.
• Personalization and recommendations: Demonstrates storing recommendation IDs on profiles, using Liquid or Catalogs/Connected Content at send time, and patterns for reminder workflows.
• Debugging & verification: Describes response handling (dispatch IDs, 4xx/5xx parsing), delivery checks in the dashboard, and common causes of suppressed sends.

Quick Start

Call the engineer-rest-api skill to construct a /messages/send payload for a transactional email including authentication, campaign_id, app_id, and Liquid personalization.