guest.joined

HMAC-SHA256 signed webhook event

A new uploader posted for the first time. Useful for greeting flows.

METHOD WEBHOOK EVENT
EVENT TYPE guest.joined
AUTH HMAC-SHA256 signed

Emitted by onPhotoUploaded the first time a unique uploader (matched by email + display name) posts to the event. Use this for first-photo thank-you SMS, audience-growth tracking, or feeding an email-collection workflow.

AUTH NOTE

Outbound webhook delivery. Verify the `Fotowall-Signature` header against your event's webhook secret before trusting the body.

Request

EXAMPLE BODY

{
  "event": "guest.joined",
  "eventId": "spring-gala-2026",
  "deliveryId": "del_01HV9X8TBR7K2M4Q6N8P0Z3W5Q",
  "timestamp": "2026-05-17T21:34:11Z",
  "data": {
    "uploaderName": "Marcus",
    "uploaderEmail": "[email protected]",
    "firstPhotoId": "ph_500x",
    "joinedAt": "2026-05-17T21:34:11Z"
  }
}

Related endpoints

Need a different shape?

The API surface is small. Tell us what you need and we'll work backward from your integration.

Request an endpoint Back to API index