> ## Documentation Index
> Fetch the complete documentation index at: https://docs.9pic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatGPT Plugin

> Use the 9Pic AI plugin to run multi-step event photo workflows from ChatGPT, with checkpoints where it asks you first.

## Overview

The **9Pic AI** plugin turns ChatGPT into an operations agent for your event photos. Instead of clicking through the dashboard step by step, you give ChatGPT a goal, such as *"set up the City 10K gallery and get the photos in"*, and it works out the steps. It reads your account, creates and configures events, connects photo folders, imports and processes photos, publishes galleries and reports back.

ChatGPT runs the routine steps on its own and **stops at the checkpoints that matter**: before it spends credits, before a gallery goes live, and whenever the organisation or event is unclear. You stay in control of cost and timing without doing the clicking.

> [!NOTE]
>
> You need a ChatGPT account and a 9Pic account. The plugin works on every 9Pic plan, including Trial, and follows your plan, credits and dashboard role exactly like the dashboard does.

## Set Up in Two Minutes

**1. Install the plugin**

Open [9Pic AI in ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6ac23532dd8c8191a44fc3f42b4e9d3e), or search for **9Pic AI** in the ChatGPT plugin directory, and choose to connect it.

**2. Sign in and approve**

ChatGPT opens the 9Pic sign-in page. Log in with the account you use at [admin.9pic.ai](https://admin.9pic.ai) and approve the access request.

**3. Check the connection**

In a new chat, ask *"List my 9Pic AI organisations."* If your organisations appear, you're ready.

> [!TIP]
>
> On ChatGPT Business, Enterprise and Edu workspaces, an admin may need to allow the 9Pic AI plugin before members can connect it.

You approve three permissions: **read events** (organisations, plan, credits, events, settings, sources and progress), **change events** (create, configure, import, process, publish and unpublish when asked) and **read analytics** (estimated gallery engagement). ChatGPT never sees your 9Pic password.

## How a Workflow Runs

When you hand ChatGPT a multi-step goal, it follows the same pattern every time:

**1. Reads before it writes**

It picks the organisation (asking if you're in more than one), finds the event, and checks your plan and credit balance before the first change.

**2. Chains the routine steps**

It creates the event, applies only the settings you named, adds the photo folder and starts the import, one tool after another, without waiting for you between steps.

**3. Tracks long-running jobs**

Imports and processing run in the background. ChatGPT checks the job status rather than assuming success, and checks before retrying so nothing is done twice.

**4. Stops at a checkpoint**

Before spending credits it shows a preview and waits for your yes. Before publishing or unpublishing it explains what participants will see.

**5. Reports what actually happened**

It reports real counts and states, for example *"1,480 of 1,500 photos processed, 20 failed, gallery still in draft"*, not just that the job was sent.

## Workflow Recipes

Copy a prompt, change the names, dates and numbers, and send it. Each one runs several steps in a single request.

### 1. Set up an event end to end

> Use the Coastal Running Club organisation. Create a running event called City 10K on 9 March 2027 at 06:00 Asia/Kolkata. Turn off bulk downloads. Add this shared folder as a photo source named Finish Line: \<link>, import the photos, and tell me how many came in. Then preview processing all of them.

ChatGPT creates the event as a **draft**, applies the setting, connects the folder, imports, waits for the import to finish and stops with a processing preview for you to approve.

### 2. Race-day pipeline

> For City 10K: import any new photos from its sources, then preview processing everything that's imported but not processed yet. After I confirm, process them and tell me when it's done. Don't publish.

Run it again every time your photographers drop a new batch into the shared folder. Importing is free, and ChatGPT only processes new photos.

### 3. Process within a budget

> We have about 3,000 photos for City 10K but only want to spend 1,500 credits today. Preview processing 1,500 photos and show me the cost.

ChatGPT processes a bounded batch after you confirm, and tells you how many photos are still waiting so you can run the rest later.

### 4. Go live at the right moment, and roll back

> Keep City 10K in draft. When I say "go", publish it and confirm it's live.

Later: *"Go."* If something is wrong, *"Move City 10K back to draft"* stops participant access straight away while keeping every photo and setting.

### 5. Race-morning readiness check

> Check every event this weekend: how many photos are imported, processed and failed, and whether each one is live. List anything that needs attention.

This one only reads, so it never changes anything. It's a safe first message of the day.

### 6. Settings audit across events

> For every event this month, check that selfie search is on, bulk download is off and the photo count is shown. Show me the differences, then fix them.

ChatGPT reads each event, reports what differs and changes only the settings you named.

### 7. Post-event engagement report

> Summarise gallery engagement for every event we ran in October and write it as a short update for our sponsors.

Figures are estimated totals and can be partial for some dates. Engagement analytics need the **Pro** plan or above.

### 8. One agent for many organisations

> List my organisations, then show the draft events in each one and which of them have photos waiting to be processed.

Useful for agencies that work for several organisers. ChatGPT keeps each organisation separate and asks when a request could apply to more than one.

## Make Your Workflows Repeatable

ChatGPT follows standing rules you give it, so you don't have to repeat them in every prompt. Save a block like this in your ChatGPT custom instructions, or in the instructions of a ChatGPT project you use for event work:

```text theme={null}
When I work with 9Pic AI:
- Use the Coastal Running Club organisation unless I name another.
- Create events in Asia/Kolkata time with bulk downloads off.
- Never process more than 2,000 photos in one batch.
- Don't publish anything until I say "go".
- After every import or processing run, give me imported, processed, failed and live counts.
```

> [!TIP]
>
> Name events consistently (for example *"City 10K 2027"*) so a short request like *"publish City 10K 2027"* always finds the right event.

## Checkpoints That Always Need You

Some steps never run without you, however the workflow is written. This keeps an agent from spending your credits or exposing a gallery by mistake.

| Step | What ChatGPT does |
| :- | :- |
| Processing photos | Shows a preview of the photos and credits it will use, then waits for your confirmation. A preview expires after 15 minutes. |
| Publishing | Explains that participants will be able to open the gallery, then publishes and checks that it's live. |
| Unpublishing | Explains that participant access stops while photos and settings stay. |
| Unclear organisation or event | Asks which one you mean. It never guesses. |
| Uncertain result | Checks the job status before trying again, and reports both results if they disagree instead of retrying and spending more credits. |
| Status questions | Only reads. *"Is City 10K ready?"* never publishes it. |

ChatGPT may also ask you to approve each change as it runs. You can keep that on.

> [!WARNING]
>
> Processing uses **1 credit per photo** while selfie or BIB search is on. ChatGPT never turns search off to save credits unless you ask. On the Trial plan, events stay private.

## What the Plugin Doesn't Do

| Request | Where to do it instead |
| :- | :- |
| Buy credits, change your plan or get a checkout link | [Credits & Billing](https://docs.9pic.ai/account/credits/overview.md) in the dashboard |
| Find or download a participant's photos | Participants search with a selfie or bib number in the event gallery |
| Edit watermarks, branding, team members or 9Pic Checkout | The dashboard: see [Photo Watermark](https://docs.9pic.ai/products/photo/watermark.md), [Your Site](https://docs.9pic.ai/account/site.md), [Team](https://docs.9pic.ai/account/team.md) and [9Pic Checkout](https://docs.9pic.ai/products/checkout/overview.md) |
| Share your password, a one-time code or an API key | Never needed. Sign-in only happens on the 9Pic sign-in page |

Every action the plugin can take is listed in [Tools and Safeguards](https://docs.9pic.ai/integrations/ai-assistants/tools.md).

## Going Fully Unattended

The plugin works while you're chatting, with you at the checkpoints. To run a pipeline with no one in the loop, for example triggered by your own upload system or on a schedule, use the **9Pic API** instead:

* Create an API key in the [Developer Zone](https://docs.9pic.ai/integrations/developer-zone.md) (Business plan, and on Trial).
* Call the photo pipeline from your own code: [Import](https://docs.9pic.ai/api-reference/pipeline/photos/import.md), [Process](https://docs.9pic.ai/api-reference/pipeline/photos/process.md), [Go Live](https://docs.9pic.ai/api-reference/pipeline/photos/go-live.md) and [Pipeline Status](https://docs.9pic.ai/api-reference/pipeline/photos/status.md).
* Let a coding agent write that integration for you with the [9Pic Agent Skill](https://docs.9pic.ai/integrations/agent-skills.md).

A common pattern is to design and test a workflow in ChatGPT first, then move the steps you trust into an API integration.

## Disconnect

Disconnect 9Pic AI from the plugins or apps section of your ChatGPT settings. ChatGPT loses access to your 9Pic account straight away. Your events, photos and settings are not affected.

## Common Questions

> [accordion] Can ChatGPT process and publish without asking me?
>
> No. Processing always needs your confirmation of a preview, and ChatGPT explains what participants will see before it publishes. For fully unattended runs, use the [9Pic API](#going-fully-unattended).

> [accordion] Can my teammates run workflows too?
>
> Yes. Each teammate connects the plugin with their own 9Pic login and can only reach the organisations and events their role allows. Add people from [Team](https://docs.9pic.ai/account/team.md).

> [accordion] Do I need ChatGPT developer mode or the server address?
>
> No. 9Pic AI is a published plugin, so you install it from the directory like any other plugin.

> [accordion] ChatGPT says processing failed, but my photos look processed.
>
> Ask ChatGPT to check the event status, or open the event's **Photo → Overview** tab. ChatGPT reports both what the job says and what the photo counts show, and it won't retry on its own and spend more credits.

> [accordion] Why are some analytics missing?
>
> Engagement figures are estimates and can be partial or unavailable for some dates. A missing number isn't zero. Engagement analytics need the Pro plan or above.

> [accordion] ChatGPT says my connection expired.
>
> Reconnect 9Pic AI from ChatGPT settings and sign in again. See [Fix Connection Issues](https://docs.9pic.ai/integrations/ai-assistants/troubleshooting.md).

## Next Steps

> [card] [Tools and Safeguards](https://docs.9pic.ai/integrations/ai-assistants/tools.md)
>
> Every action ChatGPT can take and when it asks first.

> [card] [Photo Pipeline API](https://docs.9pic.ai/api-reference/pipeline/photos/status.md)
>
> Run imports, processing and go-live from your own systems.

> [card] [Codex](https://docs.9pic.ai/integrations/ai-assistants/codex.md)
>
> Add the same 9Pic AI server to OpenAI Codex.

> [card] [Fix Connection Issues](https://docs.9pic.ai/integrations/ai-assistants/troubleshooting.md)
>
> Sign-in, expired connections and permission errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.