API Reference

Build on Drissle with our REST API

Send transactional emails, manage contacts, trigger campaigns, and receive real-time webhooks — all via a clean, predictable REST API designed for developers.

Get API keys

REST API

Clean, predictable JSON REST API with consistent resource naming and standard HTTP verbs.

Webhook Events

Real-time webhooks for delivery, open, click, bounce, unsubscribe, and custom events.

Secure Auth

API key authentication with org-scoped permissions. AES-256-GCM payload encryption available.

Rate Limits

Generous tier-based limits: Free 100/min, Starter 500/min, Growth 2,000/min, Professional 5,000/min.

Endpoints

Core API endpoints

POST/v1/transactional/sendAPI Key

Send Transactional Email

Send a single transactional email with template support, variables, and attachment handling.

POST/v1/transactional/send-batchAPI Key

Send Batch Emails

Send up to 500 transactional emails in a single request with personalised variables per recipient.

GET/v1/transactional/logsAPI Key

Get Delivery Logs

Query delivery status, opens, clicks, bounces, and spam reports with date range filtering.

POST/v1/contactsAPI Key

Create Contact

Create or update a contact with custom fields, tags, and list memberships.

GET/v1/contacts/:idAPI Key

Get Contact

Retrieve a single contact profile including engagement score, activity timeline, and tags.

POST/v1/campaigns/:id/sendAPI Key

Trigger Campaign Send

Programmatically trigger a pre-built campaign to a list or segment.

POST/v1/automations/:id/enrollAPI Key

Enroll in Automation

Manually enroll a contact into an automation flow by ID or email.

GET/v1/webhooks/eventsAPI Key

List Webhook Events

Retrieve all configured webhook event types and their delivery history.

Quick Start

Send your first email in 5 minutes

Grab your API key from the developer dashboard, copy the code below, and run it. That is it.

  • Generate an API key in Settings > Developer
  • Set your `x-api-key` header on every request
  • Use `org_id` to scope all calls to your tenant
  • Receive webhooks at your configured endpoint
curl example
curl -X POST https://api.drissle.co/v1/transactional/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: drissle_live_..." \
  -d '{
    "to": "customer@example.com",
    "template_id": "welcome-v2",
    "variables": {
      "firstName": "Amaka",
      "company": "Fashion Ark"
    }
  }'