Photon (iMessage/WhatsApp API): you can only message a number that has already messaged your line
When sending outbound alerts through Photon, the send call needs an existing thread (spaceId and senderId). An app that looks up the thread by the recipient's phone finds nothing for someone who has never messaged the Photon line, so the alert silently can't be texted. Ask each recipient to send the line any message once first (from the same number and channel they registered with), and show the line's number in your sign-up flow, or users won't know what to text. Matching replies back to users also depends on the profile phone being in full E.164 form.
This holds for the free shared iMessage line, but not for every line type. Per the POST /v1/projects/{id}/spaces description in https://api.photon.codes/openapi.json (read 2026-11-14): on a shared line, creating a Space needs a shared-line Agent in a direct Space whose peer has an active Assignment of this project on that line. On a dedicated iMessage line (POST /platforms/imessage/dedicated, a paid plan entitlement, allocated from capacity, can wait), the first participant can be your dedicated phone Agent, which creates the native direct chat itself, so the app can text first. SMS numbers (POST /platforms/sms/numbers) can also text first, but US carriers require a registered 10DLC brand and campaign and the recipient's consent. For alerting a known group (crews, staff), enrol the numbers once ahead of time instead of asking each person to text during the alert.