Plunk Documentation

Send your first email

1. Get your API key

Sign up at Plunk dashboard
Create or select a project
Go to Settings > API Keys
Copy your Secret Key (starts with sk_)

2. Send an email

curl -X POST https://api.mailer.evogic.solutions/v1/send \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "recipient@example.com",
    "subject": "Hello from Plunk",
    "body": "<h1>It works!</h1><p>Your first email via Plunk.</p>"
  }'

Response:

{
  "success": true,
  "emails": [{
    "contact": {
      "id": "contact_abc123",
      "email": "recipient@example.com"
    },
    "email": "email_xyz789"
  }],
  "timestamp": "2024-03-15T10:30:00.000Z"
}

The email is queued and delivers within seconds.

Use variables

Make emails dynamic with template variables:

curl -X POST https://api.mailer.evogic.solutions/v1/send \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Welcome {{firstName}}!",
    "body": "<h1>Hello {{firstName}}</h1><p>Welcome to {{companyName}}.</p>",
    "data": {
      "firstName": "Sarah",
      "companyName": "Acme Inc"
    }
  }'

Variables use {{variableName}} syntax and pull from the data object.

Send to multiple recipients

Pass an array to send the same email to multiple people:

{
  "to": ["user1@example.com", "user2@example.com", "user3@example.com"],
  "subject": "Team update",
  "body": "<p>Check out our new features!</p>"
}

Each recipient gets their own email with personalized data if provided.

Use saved templates

Create reusable templates in the dashboard, then reference them by ID:

curl -X POST https://api.mailer.evogic.solutions/v1/send \
  -H "Authorization: Bearer sk_your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "template": "welcome-email-template-id",
    "data": {
      "firstName": "Sarah",
      "verificationUrl": "https://example.com/verify/abc123"
    }
  }'

The template's subject, body, and sender settings are used automatically. Your data fills in the template variables.

Track events

Track user actions to trigger workflows and build segments:

curl -X POST https://api.mailer.evogic.solutions/v1/track \
  -H "Authorization: Bearer pk_your_public_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "event": "signed_up",
    "data": {
      "plan": "pro",
      "source": "landing_page"
    }
  }'

This creates or updates the contact and tracks the event. Use events to trigger automated workflows.

What's next

Set up workflows — Build automated email sequences with workflows

Manage contacts — Import and segment your audience with contacts

Send campaigns — Broadcast to your entire list with campaigns

Track engagement — Monitor opens and clicks with analytics

Quick Start