Skip to content

Day-1 nudge email to stalled sign-ups, dry run by default (POST) — cronstalledsignupnudgepost

POST
/cron/stalled-signup-nudge
curl --request POST \
--url https://example.com/api/cron/stalled-signup-nudge

Same as GET. A JSON body dry_run is read only when the query string has none. Protected by CRON_SECRET via the x-cron-secret header.

dry_run
string

0 runs live; anything else, or absent, is a dry run.

Nudge run counts

Media type application/json
object
ok
required

False on any error.

boolean
dry_run
required

True unless the caller sent dry_run=0.

boolean
would_claim
required

Dry run only — users a live tick would claim now; null on a live run or a failed preview.

integer | null
claimed
required

Users claimed by this run.

integer
sent
required

Nudges accepted by Mailgun.

integer
skipped
required

Claimed users deliberately not emailed (E2E identities, or no longer eligible at send time).

integer
failed
required

Definite pre-delivery failures; retried after the lease until the attempt ceiling.

integer
unknown
required

Sends whose delivery is unknown (timeout/abort); terminal, never retried.

integer
deferred
required

Claimed users not attempted this run (the circuit breaker after a failed or unknown send, or the 90s send deadline); left pending and re-claimed after the lease.

integer
errors
required

Failures of any kind (preview, claim, send, or outcome bookkeeping).

integer

Missing or invalid CRON_SECRET