SapaganDocs sapagan.com

Resources

Changelog

What changed in the API and the SDKs, newest first.

The API is versioned with the contract in openapi.json (version 0.1.0). Sapagan is in its pilot phase, so routes can still be added. Breaking changes are listed here before they ship.

November 2026#

2026-11-17#

  • Webhooks. A journey can send a signed POST to your URL, with X-Sapagan-Signature, retries over about 18 hours and an SSRF guard. See Webhooks.
  • Email. Deliverability checks per sending domain. See Email sending domain.
  • Web hosts move to sapagan.com.

2026-11-16#

  • Identity tokens. App keys and Track keys in workspaces that require identity must send X-Sapagan-User-Token with profile writes and device registrations. New production workspaces require it from the start. See Identity tokens.
  • Web origins and origin_not_allowed for browser calls.
  • Workspace type. marketplace and own_brand. Store routes answer 404 in an own brand workspace.
  • Email feedback. SES bounces and complaints create suppressions.
  • Setup and testing. Push credentials, test people and "Send a test" for campaigns and journeys.
  • Email designer, in-app templates and store flows in the console.
  • @sapagan/web 0.3.0 and sapagan_flutter 0.4.0 (below).

2026-11-15#

  • Transactional API. POST /v1/send, GET /v1/send/{id}, GET /v1/send/stats. See Transactional messages.
  • Web push through FCM, and in-app messages (GET /v1/inapp/messages, POST /v1/inapp/events).
  • Email sending through Amazon SES, with email templates.
  • Journeys and the journey runner.
  • Public SDK names become Sapagan: sapagan_flutter, @sapagan/web, X-Sapagan-* headers. The old X-Kentongan-* names are accepted until 2027-05-31.

2026-11-14#

  • Native batch API POST /v1/batch, customers, consent topics and the PDP export and delete routes.
  • Customer.io Track API v1 and v2 compatibility on /api/v1 and /api/v2.
  • Broadcasts, approval and the dispatcher, with quiet hours and frequency caps.
  • Product name is Sapagan.

SDKs#

sapagan_flutter 0.4.0 (2026-11-16)#

  • New SapaganConfig.userTokenProvider, sent as X-Sapagan-User-Token with batches that identify the user, update a profile, register a device or add a relationship.
  • A refused token (401 invalid_user_token) is asked for again and the batch retried at once. Per-item refusals are dropped and logged by code only.
  • With identity tokens, identify keeps email and phone as attributes. Your backend sets them.
  • In-app fetches use userTokenProvider when InAppConfig.sessionTokenProvider is not set.

sapagan_flutter 0.3.0#

Renamed from kentongan_flutter. Stored data moves over by itself.

@sapagan/web 0.3.0 (2026-11-16)#

  • New getUserToken option, sent with the browser's registration.
  • New result { status: "error", code: "identity" } when the token is refused twice or required.
  • App keys are the recommended key for pages. The worker sends X-Sapagan-Sdk: web/0.3.0.

@sapagan/web 0.2.0 (2026-11-16)#

Renamed from @kentongan/web: createSapagan, sapagan-sw.js, and sapagan.web.* storage keys. Keep serving the old kentongan-sw.js shim until 2027-05-31 for browsers that subscribed under 0.1.x.