API reference

Webhooks, queue, SeleMail, routing and push API

All APIs · SDKs · Continue with SeleID (OIDC) · SeleStorage · SeleBase · Webhooks, queue, SeleMail, routing and push · SeleAI · SeleDomains search

Coming soon Version 1.0.0. Webhooks signed with HMAC-SHA256 (header seleid-signature: t=<unix>,v1=<hex> over "<t>.<body>"), a durable job queue, email sending, inbound routing and push. Auth reuses the SeleStorage key table.

Base URL

https://api.seleid.dev Base URL.

Authentication and scopes

Bearer API key. Scopes: read, write, admin.

Rate limits and quotas

Monthly queue operations and mail sends by plan are hard stops (429 quota_exceeded, allowance_exceeded). Mail overage happens only if you set an overage limit.

Endpoints

• GET /v1/webhooks/endpoints List webhook endpoints
• POST /v1/webhooks/endpoints Create a webhook endpoint
• DELETE /v1/webhooks/endpoints/{id} Delete an endpoint
• POST /v1/webhooks/endpoints/{id}/rotate Rotate the signing secret
• POST /v1/events Emit an event to matching endpoints
• GET /v1/webhooks/deliveries Delivery log
• POST /v1/webhooks/deliveries/{id}/replay Replay a delivery
• GET /v1/queue/dead List exhausted jobs
• POST /v1/queue/dead/{id}/retry Retry an exhausted job
• GET /v1/usage Usage this month
• POST /v1/mail/send Send an email
• PUT /v1/mail/overage-limit Set the overage limit
• GET /v1/mail/suppressions List suppressed addresses
• DELETE /v1/mail/suppressions/{email} Remove a suppression
• POST /v1/mail/bounces Report a bounce
• POST /v1/routing/domains Add an Email Routing domain
• GET /v1/routing/rules List routing rules
• POST /v1/routing/rules Add a routing rule
• DELETE /v1/routing/rules/{id} Remove a routing rule
• POST /v1/push/devices Register a device token
• DELETE /v1/push/devices/{id} Unregister a device
• POST /v1/push/send Send a push to a user

curl -X GET "https://api.seleid.dev/v1/webhooks/endpoints" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/webhooks/endpoints', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.seleid.dev/v1/webhooks/endpoints",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/webhooks/endpoints" \
  -H "Authorization: Bearer $SELE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hooks/sele","events":["order.created"]}'

const res = await fetch('https://api.seleid.dev/v1/webhooks/endpoints', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "url": "https://example.com/hooks/sele",
    "events": [
      "order.created"
    ]
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/webhooks/endpoints",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"},
    json={
        "url": "https://example.com/hooks/sele",
        "events": [
            "order.created",
        ],
    }
)
print(res.status_code, res.text)

curl -X DELETE "https://api.seleid.dev/v1/webhooks/endpoints/YOUR_ID" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/webhooks/endpoints/YOUR_ID', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.delete(
    "https://api.seleid.dev/v1/webhooks/endpoints/YOUR_ID",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/webhooks/endpoints/YOUR_ID/rotate" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/webhooks/endpoints/YOUR_ID/rotate', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/webhooks/endpoints/YOUR_ID/rotate",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/events" \
  -H "Authorization: Bearer $SELE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"order.created","data":{"id":"o_1"}}'

const res = await fetch('https://api.seleid.dev/v1/events', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "type": "order.created",
    "data": {
      "id": "o_1"
    }
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/events",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"},
    json={
        "type": "order.created",
        "data": {
            "id": "o_1",
        },
    }
)
print(res.status_code, res.text)

curl -X GET "https://api.seleid.dev/v1/webhooks/deliveries" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/webhooks/deliveries', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.seleid.dev/v1/webhooks/deliveries",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/webhooks/deliveries/YOUR_ID/replay" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/webhooks/deliveries/YOUR_ID/replay', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/webhooks/deliveries/YOUR_ID/replay",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X GET "https://api.seleid.dev/v1/queue/dead" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/queue/dead', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.seleid.dev/v1/queue/dead",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/queue/dead/YOUR_ID/retry" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/queue/dead/YOUR_ID/retry', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/queue/dead/YOUR_ID/retry",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X GET "https://api.seleid.dev/v1/usage" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/usage', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.seleid.dev/v1/usage",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/mail/send" \
  -H "Authorization: Bearer $SELE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"hello@yourdomain.com","to":"ada@example.com","subject":"Welcome","text":"Hi Ada"}'

const res = await fetch('https://api.seleid.dev/v1/mail/send', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "from": "hello@yourdomain.com",
    "to": "ada@example.com",
    "subject": "Welcome",
    "text": "Hi Ada"
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/mail/send",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"},
    json={
        "from": "hello@yourdomain.com",
        "to": "ada@example.com",
        "subject": "Welcome",
        "text": "Hi Ada",
    }
)
print(res.status_code, res.text)

curl -X PUT "https://api.seleid.dev/v1/mail/overage-limit" \
  -H "Authorization: Bearer $SELE_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

const res = await fetch('https://api.seleid.dev/v1/mail/overage-limit', {
  method: 'PUT',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({}),
});
const data = await res.json();

import os, requests

res = requests.put(
    "https://api.seleid.dev/v1/mail/overage-limit",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"},
    json={}
)
print(res.status_code, res.text)

curl -X GET "https://api.seleid.dev/v1/mail/suppressions" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/mail/suppressions', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.seleid.dev/v1/mail/suppressions",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X DELETE "https://api.seleid.dev/v1/mail/suppressions/YOUR_EMAIL" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/mail/suppressions/YOUR_EMAIL', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.delete(
    "https://api.seleid.dev/v1/mail/suppressions/YOUR_EMAIL",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/mail/bounces" \
  -H "Authorization: Bearer $SELE_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

const res = await fetch('https://api.seleid.dev/v1/mail/bounces', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({}),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/mail/bounces",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"},
    json={}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/routing/domains" \
  -H "Authorization: Bearer $SELE_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

const res = await fetch('https://api.seleid.dev/v1/routing/domains', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({}),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/routing/domains",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"},
    json={}
)
print(res.status_code, res.text)

curl -X GET "https://api.seleid.dev/v1/routing/rules" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/routing/rules', {
  method: 'GET',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.seleid.dev/v1/routing/rules",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/routing/rules" \
  -H "Authorization: Bearer $SELE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"yourdomain.com","local":"support","action":{"type":"forward","to":"team@example.com"}}'

const res = await fetch('https://api.seleid.dev/v1/routing/rules', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "domain": "yourdomain.com",
    "local": "support",
    "action": {
      "type": "forward",
      "to": "team@example.com"
    }
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/routing/rules",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"},
    json={
        "domain": "yourdomain.com",
        "local": "support",
        "action": {
            "type": "forward",
            "to": "team@example.com",
        },
    }
)
print(res.status_code, res.text)

curl -X DELETE "https://api.seleid.dev/v1/routing/rules/YOUR_ID" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/routing/rules/YOUR_ID', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.delete(
    "https://api.seleid.dev/v1/routing/rules/YOUR_ID",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/push/devices" \
  -H "Authorization: Bearer $SELE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"userId":"u1","platform":"android","token":"DEVICE_TOKEN"}'

const res = await fetch('https://api.seleid.dev/v1/push/devices', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "userId": "u1",
    "platform": "android",
    "token": "DEVICE_TOKEN"
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/push/devices",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"},
    json={
        "userId": "u1",
        "platform": "android",
        "token": "DEVICE_TOKEN",
    }
)
print(res.status_code, res.text)

curl -X DELETE "https://api.seleid.dev/v1/push/devices/YOUR_ID" \
  -H "Authorization: Bearer $SELE_KEY"

const res = await fetch('https://api.seleid.dev/v1/push/devices/YOUR_ID', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.delete(
    "https://api.seleid.dev/v1/push/devices/YOUR_ID",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"}
)
print(res.status_code, res.text)

curl -X POST "https://api.seleid.dev/v1/push/send" \
  -H "Authorization: Bearer $SELE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"userId":"u1","title":"Hello","body":"You have a message"}'

const res = await fetch('https://api.seleid.dev/v1/push/send', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.SELE_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "userId": "u1",
    "title": "Hello",
    "body": "You have a message"
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.seleid.dev/v1/push/send",
    headers={"Authorization": f"Bearer {os.environ['SELE_KEY']}"},
    json={
        "userId": "u1",
        "title": "Hello",
        "body": "You have a message",
    }
)
print(res.status_code, res.text)

Errors

The machine-readable OpenAPI 3.1 description for this API lives in the SeleID repository under docs/openapi/.