Skip to main content

Overview

Triggers a photo import from the sources configured in the dashboard for the given event. This is pipeline step 1 — it pulls images from Google Drive, Dropbox, or other connected sources into 9Pic. For API-key requests, the job is asynchronous: this endpoint only queues work. The response returns status: "processing"; track completion with Pipeline Status via stages.import.status (processed or failed).
Photo sources must be configured in the 9Pic dashboard before calling this endpoint. OAuth clients can also configure sources through Photo Sources.

Endpoint

Path Parameters

Example Request

Example Response

Error Responses

See Errors for canonical descriptions and retry guidance.

OAuth Request

OAuth only. Read calls require events:read. Writes require both events:read and events:write, plus an accepted organiser admin membership. Send a bearer token without X-API-Key. The API-key request and response above remain unchanged. For OAuth, use the same path with the JSON body below. Import uses no credits and runs in one call: send mode: "execute" with a stable idempotency_key. No review token or confirmation is needed; mode: "preview" is an optional dry run. See Operations for retry rules.

Example Request

Example Response

OAuth Response Models

GuardedOperationData replaces the API-key stage-start response. Track operation_id through Operations, alongside Pipeline Status. pending or queued means the work was accepted, not completed; uncertain dispatch is dispatch_unknown.