API Documentation

Integrate FotoFit into your apps with our REST API.

Base URL

-proxy

Public Endpoints

GET/api/v1/public/campaigns

List published campaigns

Params: page, limit, search, sort (newest|popular)

GET/api/v1/public/campaigns/:projectId

Get campaign details and frames

Params: projectId or slug

POST/api/v1/public/campaigns/:projectId/apply

Apply frame overlay to photo

Params: photo (file), frameId

GET/api/v1/verify/:verificationId

Verify a certificate

Params: verificationId (FFT-XXXX-XXXX)

POST/api/v1/analytics/track

Track campaign event

Params: projectId, eventType (view|apply|download|share)

Embed Widget

Add a FotoFit campaign to any website with an iframe:

<iframe
  src="https://fotofit.in/embed/YOUR_PROJECT_ID"
  width="450"
  height="600"
  frameborder="0"
  style="border-radius: 12px; border: 1px solid #e5e7eb;"
></iframe>

Webhooks

Configure webhooks in your dashboard settings to receive real-time notifications for job.completed, job.failed, and campaign.apply events. Payloads are signed with HMAC-SHA256 via the X-FotoFit-Signature header.