Skip to main content

Quick Start Guide

Get started with MessagePipe in minutes. This guide will walk you through creating your first email template and sending a message.

Prerequisites​

  • A MessagePipe account
  • An API key (generated from your dashboard)
  • A configured email provider

Step 1: Get Your API Key​

  1. Log into your MessagePipe dashboard
  2. Select your preferred Project → Click on API Keys
  3. Click Create API Key
  4. Copy the generated API key and store it in a secure place (you won't see it again!)

Step 2: Create Your First Email Template​

curl -X POST "https://mzl-email-template-engine.dev.zero.mangozestlabs.com/templates" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: text/html" \
  -d '<h1>Welcome!</h1><p>Thanks for joining {{companyName}}.</p>' \
  --data-urlencode "projectId=your-project-id" \
  --data-urlencode "name=welcome-email" \
  --data-urlencode "subject=Welcome to Our Platform"

Response:

{
  "id": "project-uuid",
  "name": "welcome-email",
  "body": "<h1>Welcome!</h1><p>Thanks for joining {{companyName}}.</p>",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z",
  "project": {
    "id": "project-uuid",
    "name": "project-name"
  }
}

Step 3: Send Your First Email​

curl -X POST "https://mzl-email-template-engine.dev.zero.mangozestlabs.com/email/send" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "template-uuid",
    "to": "user@example.com",
    "variables": {
      "companyName": "Nobu"
    }
  }'

Response:

{
  "message": "Email sent successfully",
  "messageId": "msg-id"
}

Step 4: Create and Send an SMS​

# Create SMS template
curl -X POST "https://mzl-email-template-engine.dev.zero.mangozestlabs.com/sms-templates" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "your-project-id",
    "name": "verification-sms",
    "body": "Your verification code is {{code}}."
  }'

# Send SMS
curl -X POST "https://mzl-email-template-engine.dev.zero.mangozestlabs.com/sms/send" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "sms-template-id-uuid",
    "to": "+1234567890",
    "variables": {
      "code": "123456"
    }
  }'

What's Next?​

Now that you've sent your first messages, explore these topics:

Common Issues​

Authentication Error (401)​

  • Verify your API key is correct
  • Ensure you're using x-api-key header for sending operations
  • Check that your API key hasn't been disabled

Template Not Found (404)​

  • Verify the template ID exists
  • Ensure you're using the correct project context

Provider Configuration Missing​

  • Configure at least one email/SMS provider in your project settings
  • Enable the provider in your configuration

Testing the API​

Use our API Reference page to test endpoints interactively with your actual API key.