Utsendinger

Hent utsendingene

Nyeste først. Kundepost fra et nettsted deler tabellen, men hører ikke til her og kommer ikke med: den går til en annen liste, med sin egen avmelding.

?status

utkast, planlagt, sender, sendt, avbrutt eller feilet.

?limit

1 til 100. Standard er 25.

?cursor

next_cursor fra forrige side.

?format

markdown legger til markdown på hver utsending.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/broadcasts?status=paid&limit=20"

Skriv en utsending

Uten send og uten scheduled_for blir utsendingen et utkast, og ingenting går ut. send: true sender med det samme og krever både Idempotency-Key og newsletter:send; scheduled_for legger den i kø til et tidspunkt og krever newsletter:send. De to kan ikke stå sammen. dry_run: true teller mottakerne og lagrer ingenting.

Idempotency-Key:

En verdi du finner på selv, unik for denne utsendingen. Påkrevd når kallet faktisk sender, unødvendig på en prøve og på en planlegging. Prøver du igjen med den samme, får du svaret fra første gang i stedet for en e-post til.

{
  "broadcast": {
"id": "6f1c2a90",
"subject": "Ukas brev",
"audience": "all",
"status": "utkast",
"scheduled_for": null,
"sent_at": null,
"recipient_count": 0,
"sent_count": 0,
"failed_count": 0,
"created_at": "2026-09-04T09:00:00.000Z"
  }
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/broadcasts" \
  -X POST \
  -H "content-type: application/json" \
  -d '{
    "subject": "Ukas brev",
    "markdown": "## Juli\n\nDet ble en lang måned.",
    "audience": "all"
  }'

Hent én utsending

?format

markdown legger til markdown.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
broadcast_id="abc123"

skribb "/broadcasts/$broadcast_id?format=markdown"

Send utsendingen

En utsending går ut én gang. Har den gått ut før, svarer vi 409 already-sent, og det finnes ingen force; står den som feilet, kan du sende den om igjen. Publikasjonen fører sin egen liste over hva som har gått ut, så en abonnent som likevel rakk å få den, får den ikke to ganger. dry_run: true svarer med hvor mange den ville gått til, uten å sende noe og uten å kreve en nøkkel, og avviser det samme en ekte utsending ville avvist. scheduled_for legger den i kø til tidspunktet i stedet, og ingenting går ut nå.

Idempotency-Key:

En verdi du finner på selv, unik for denne utsendingen. Påkrevd når kallet faktisk sender, unødvendig på en prøve og på en planlegging. Prøver du igjen med den samme, får du svaret fra første gang i stedet for en e-post til.

{
  "send": {
"dry_run": false,
"recipient_count": 412,
"sent_count": 411,
"failed_count": 1
  }
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
broadcast_id="abc123"

skribb "/broadcasts/$broadcast_id/send" \
  -X POST \
  -H "content-type: application/json" \
  -d '{
    "dry_run": true
  }'

Avlys utsendingen

Et utkast ingen har sett blir borte. En planlagt utsending blir stående som avbrutt, fordi «denne sendte vi ikke» er noe du kan trenge å vise til seinere. En som er på vei ut eller allerede sendt, svarer 409 already-sent: det er ingenting igjen å avlyse. En som står som feilet, svarer 409 broadcast-failed, av samme grunn: vi nådde ikke publikasjonen, og da vet vi ikke om noe rakk å gå ut.

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
broadcast_id="abc123"

skribb "/broadcasts/$broadcast_id" \
  -X DELETE