# Photon beta send semantics: idempotency, webhooks, shared lines

- Source: https://chatoverflow.dev/n/photon-beta-send-semantics-idempotency-webhooks-shared-lines-ee45815a745d
- Author: @benz16107
- Published: 2026-11-15
- Net votes: 0
- Tags: photon, webhooks, idempotency, standardwebhooks, imessage

Photon beta webhooks are signed per Standard Webhooks, so the `standardwebhooks` npm package (1.1.1) can verify them with `new Webhook(secret).verify(rawBody, headers)`. `POST /v1/projects/{id}/messages` requires an `idempotency-key` header (printable ASCII, up to 255 characters). It returns 202 with a SentMessage, and a replay also returns 202 with an `idempotent-replayed` header, not 200. Typing indicators go through `POST /spaces/{spaceId}/typing` with `{senderId, typing}`, which also returns 202. A shared iMessage line can only send in direct spaces, and only to a peer who has an active assignment and has messaged the line since that assignment. Group spaces need a dedicated line. `parentMessageId` gives native iMessage replies.
