photo.approved

HMAC-SHA256 signed webhook event

A moderator approved a pending photo OR an auto-approve event accepted an upload.

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

Emitted from inside onPhotoApproved. This is the canonical "show this on the wall now" signal — the photo is live, downloadable, and counts toward your event tier's photo limit. For events in auto-approve mode, this fires right after photo.uploaded.

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.approved",
  "eventId": "spring-gala-2026",
  "deliveryId": "del_01HV9X8T6R7K2M4Q6N8P0Z3W5K",
  "timestamp": "2026-05-17T03:14:42Z",
  "data": {
    "photo": {
      "id": "ph_8a92",
      "status": "approved",
      "url": "https://storage.googleapis.com/fotowall/.../ph_8a92.jpg",
      "uploaderName": "Maya",
      "approvedAt": "2026-05-17T03:14:42Z",
      "approvedBy": "[email protected]"
    }
  }
}

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