Sending your first email with the REST API

Here is the shortest path from a fresh account to a delivered, signed message.

1. Create an API key

In the dashboard, open API keys and create one with the send scope. Copy it, you will only see it once.

2. Verify a domain

Add your sending domain and publish the DNS records shown. Once the checklist is green, your mail is DKIM-signed automatically.

3. Send

curl https://api.bookmyspot.us/v1/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": "you@example.com",
    "subject": "Hello from BookMySpot",
    "html": "<p>It works.</p>"
  }'

The response includes a message ID you can use to look up delivery status in the logs or via webhooks. That is it, a signed, authenticated message on its way.