Documentation

Everything you need to integrate MARC and start sending emails at scale.

Quick Start

Get up and running with MARC in under 5 minutes.

1

Create an Account

Sign up at getmarc.co.uk/admin/login and verify your email.

2

Connect AWS Account

Add your AWS credentials with SES permissions in the dashboard.

3

Get API Token

Generate an API token from your profile settings.

4

Send Your First Email

Use the API to send an email!

Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer your-api-token

Sending Emails

Send emails via the REST API with a simple POST request.

Endpoint

POST /api/campaigns/{campaign_id}/messages

Request Body

{
  "to": "[email protected]",
  "subject": "Hello from MARC",
  "html": "<h1>Welcome!</h1><p>Your email content here.</p>",
  "text": "Welcome! Your email content here."
}

Example (cURL)

curl -X POST https://getmarc.co.uk/api/campaigns/1/messages \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[email protected]",
    "subject": "Hello",
    "html": "<p>Hello World</p>"
  }'

Webhooks

Receive real-time notifications for email events.

Event Types

Delivery

Email was successfully delivered to the recipient.

Bounce

Email bounced (hard or soft bounce).

Complaint

Recipient marked the email as spam.

Open

Recipient opened the email (if tracking enabled).

Error Handling

The API returns standard HTTP status codes.

Code Meaning
200 Success
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid or missing token
429 Rate Limited - Too many requests
500 Server Error