photo.uploaded

HMAC-SHA256 signed webhook event

Fires when a guest uploads a photo. Also fires while moderation is on and the photo is still pending.

METHOD WEBHOOK EVENT
EVENT TYPE photo.uploaded
AUTH HMAC-SHA256 signed

Emitted by onPhotoUploaded the moment a guest finishes uploading. This is the right hook for "new content alert" workflows. If the event is in auto-approve mode, expect photo.approved shortly after. If it is this guest's first photo on the event, you also get a guest.joined event.

AUTH NOTE

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

Request

EXAMPLE BODY

{
  "event": "photo.uploaded",
  "eventId": "spring-gala-2026",
  "deliveryId": "del_01HV9X8T5R7K2M4Q6N8P0Z3W5J",
  "timestamp": "2026-05-17T03:14:00Z",
  "data": {
    "photo": {
      "id": "ph_8a92",
      "status": "pending",
      "url": "https://storage.googleapis.com/fotowall/.../ph_8a92.jpg",
      "uploaderName": "Maya",
      "uploaderEmail": "[email protected]",
      "table": "Table 4",
      "createdAt": "2026-05-17T03:14:00Z"
    }
  }
}

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