Webhooks - AI Gen Studio

Add webhook_url to a create request when you want AI Gen Studio to notify your backend about job progress.

{
  "input": [
    {
      "image_url": "https://client.example/images/sku-001.jpg",
      "external_id": "sku-001"
    }
  ],
  "creative": {
    "platform": "Instagram",
    "goal": "product launch",
    "style": "premium campaign"
  },
  "webhook_url": "https://client.example/webhooks/aigenstudio"
}

Webhook URLs must use HTTPS.

Headers

Webhook deliveries include:

X-Aigen-Signature
X-Aigen-Timestamp
X-Aigen-Event-Id

Verify the signature before trusting the payload.

Event types

image_api.result.completed
image_api.result.failed
image_api.job.completed
image_api.job.failed
image_api.job.partially_completed

Example payload

{
  "id": "evt_01jz...",
  "type": "image_api.result.completed",
  "created_at": "2026-06-28T10:30:00.000Z",
  "job": {
    "id": "f693e677-51e0-4ebe-80a0-ad06acbc4443",
    "api": "ad_creative",
    "status": "processing",
    "sandbox": false
  },
  "result": {
    "id": "0df8a...",
    "external_id": "sku-001",
    "status": "completed",
    "result_url": "https://cdn.aigenstudio.app/outputs/sku-001.png",
    "thumbnail_url": "https://cdn.aigenstudio.app/outputs/sku-001-thumb.png"
  }
}

Retries

AI Gen Studio retries failed webhook deliveries with bounded retry attempts. Return any 2xx response after your backend stores the event successfully. Use GET /jobs/{jobId} as the final source of truth if webhook delivery is delayed.