Quickstart: Shell scripting

No official CLI yet — but the API is script-friendly by design. This pattern covers deploy notifications, cron alerts, and CI pipelines.

notify.sh

#!/usr/bin/env bash
set -euo pipefail
KEY="calder_sk_test_…"

# Send — dated idempotency key: safe to re-run all day.
ID=$(curl -s https://api.calder.click/v1/emails …)

# Poll status until it leaves the queue.
for i in $(seq 1 10); do … done

Use dated keys for recurring jobs. deploy-notify-$(date +%F) means a retried cron run replays instead of double-sending — idempotency doing yard work.

Store the key in an environment variable or secret store, never in the script. Then see Webhooks to stop polling entirely.