Send a notice to a group of pass holders (hosts and organizers only)
event_pass_noticeSends a notice from the organizer of an event, or a host of a personal event, to the people who added the event pass to their phone's Wallet ("doors open at 7 now", "the keynote moved to Hall B", "Sonar meetup at The Bar on 2nd at 8 PM"). Needs a personal connector token, eventIdOrName, audience and text. Each pass holder in the chosen group sees the line on their lock screen (Apple Wallet shows it as the pass's own change notice; Google Wallet shows it as a Wallet notification) and the line stays on the pass. audience names the group: everyone, one ticket tier, one badge intent, an explicit list of pass serials, the people who scanned at a booth, or the people who answered an earlier meetup notice yes or no. A meetup is a notice with a place: placeLabel, with latitude and longitude when known, makes the pass surface again on the lock screen near that place reading "Sonar meetup inside, show this pass."; at gives the hour. It works in two steps: a call without confirm returns a preview with the number of passes in the group and the exact lock-screen line for the organizer to approve, and sends nothing; a call with confirm true sends. Only the hosts or the organizer of the event can send; anybody else is refused. The vendor audience "my_booth" is switched off by ruling and returns VENDOR_OFF. Six notices an hour per event; a seventh returns RATE_LIMITED. It reaches pass holders only; it does not tell anybody who else is there, and it does not report that a person arrived.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | OPTIONAL, for a meetup: the hour, as a full timestamp with a time zone ("2027-06-12T20:00:00-07:00"). | |
| text | Yes | REQUIRED. The notice, one plain line of up to 120 characters, in the organizer's words. This exact line is what the lock screen shows. No links, no markup. | |
| tier | No | For audience "tier": general, vendor or host. | |
| intent | No | For audience "intent": Buyer, Vendor, Networker or Social. | |
| boothId | No | For audience "booth" or "my_booth": the booth id. | |
| confirm | No | Absent for a preview: the reply gives the number of passes in the group and the exact lock-screen line, and nothing is sent. true sends the notice. | |
| serials | No | For audience "serials": the pass serial numbers, at most fifty. | |
| audience | Yes | Who the notice is for. "everyone" is every pass of the event; "tier" one ticket tier (with `tier`); "intent" one badge intent (with `intent`); "serials" an explicit list (with `serials`); "booth" the people who scanned at a booth the organizer names (with `boothId`); "meetup_yes" or "meetup_no" the people who answered an earlier meetup notice (with its `noticeId`). "my_booth" is a vendor sending to their own leads; it is switched off by ruling and returns VENDOR_OFF. | |
| latitude | No | OPTIONAL, for a meetup: the place's latitude. Both coordinates or neither. | |
| noticeId | No | For audience "meetup_yes" or "meetup_no": the noticeId an earlier meetup notice answered with. | |
| longitude | No | OPTIONAL, for a meetup: the place's longitude. Both coordinates or neither. | |
| requestId | No | Optional. An id for this notice chosen by the caller; one id sends once. | |
| placeLabel | No | OPTIONAL, for a meetup: the name of the place ("The Bar on 2nd"). With `latitude` and `longitude` the pass surfaces on the lock screen when the person is near it. | |
| relevantText | No | OPTIONAL, for a meetup with coordinates: the line the lock screen shows NEAR the place. Default: "Sonar meetup inside, show this pass." | |
| eventIdOrName | Yes | REQUIRED. The event id or the event name as the organizer or the hosts spell it. |