Developer Reference

API REFERENCE

Integrate our AI-powered photobook creation pipeline directly into your platform. RESTful endpoints, bearer authentication, and comprehensive error handling.

Photobooks Create API

v1.0.0

Synchronous API that downloads image URLs, processes them through the image pipeline, creates a photobook with distributed layout, persists it, and returns a claim URL pointing to the editor so the photobook can be claimed.

Authentication

All requests must include an `Authorization: Bearer <token>` header. Contact us to obtain an API token.

Base URL:/api

Authentication

Header

Authorization: Bearer <your-api-key>

post/photobooks/create

Create a photobook from image URLs

Downloads each image URL, processes it through `ImageProcessingService`,

Request Body Schema

metaPhotobookMetarequired

imagesarray<string>requiredmin: 1

Ordered list of image URLs to download and process

Example Request

Request Body

{
  "meta": {
    "requestDate": "2026-06-01T10:00:00.000Z",
    "conversationId": "campaign-summer-2026",
    "customerIdentifier": "user@example.com",
    "photobookName": "Summer 2026"
  },
  "images": [
    "https://cdn.example.com/photos/photo1.jpg",
    "https://cdn.example.com/photos/photo2.jpg",
    "https://cdn.example.com/photos/photo3.jpg"
  ]
}

Interactive Mock Tester

Simulated — no real requests

Request

post/photobooks/create

Authorization: Bearer

Request Body (JSON)

Simulate response

Response

Click Try it to see a simulated response

API REFERENCE

Photobooks Create API

Authentication

LET’S BUILD SOMETHING TOGETHER.