> ## Documentation Index > Fetch the complete documentation index at: https://www.dropfans.io/developers/llms.txt > Use this file to discover all available pages before exploring further. # POST /api/external/v1/drops — Create a sellable drop from vault items > Packages up to 10 vault items into a drop and returns a checkout URL. - Source: https://www.dropfans.io/developers/reference/create-drop - Section: API reference - OpenAPI: https://www.dropfans.io/developers/openapi.json Also served at `/api/external/drops` (the unversioned alias). Packages up to 10 vault items into a drop and returns a checkout URL. Price is USD **dollars**: either `0` (free) or between $5 and $750. Use APPROVED vault items — the drop inherits its moderation status from its media, so a drop built from approved items is sellable (and attachable to a post) immediately, while one containing PENDING items waits for review. Hand the buyer the returned `buyUrl`, or build a Telegram link from [GET /api/external/v1/links](https://www.dropfans.io/developers/reference/get-links.md)' `telegram.buyTemplate`. **One drop, many fans.** Don't create a copy per recipient. Create the drop once and give each fan their own link with a reference: `buyUrl?m={yourRef}` on the web, or `startapp=b_{productId}_{yourRef}` in Telegram. The reference comes back on every paid order — see [Broadcast one drop to many fans](https://www.dropfans.io/developers/guides/broadcast-one-drop.md). Different prices still need separate drops. > [!WARNING] `description` is validated but NOT stored > The `description` field runs through the prohibited-word filter and is then deliberately discarded — it is never shown anywhere on Dropfans. You get a 200 with no indication it was dropped. Treat it as a moderation input only. ## Authentication `Authorization: Bearer dpfn_...` — an API key generated in the dashboard (Vault → API Connect). By default the key acts for the one account it belongs to. Missing or invalid keys return 401 `{"error":"Unauthorized","code":"unauthorized"}`. **For a creator you manage or onboarded:** `POST /api/external/v1/creators/{creatorId}/drops` — with a verified agency's own key for a creator or AI persona it manages, or your app owner's own key for an account your app onboarded (ids from GET /api/external/v1/creators); for a managed creator the agency needs `canManageDrops`. The response echoes the account acted on in `X-Dropfans-Account`. Sending `X-Dropfans-Account: ` on the plain path still works but is deprecated. ## Request body (application/json) | Field | Type | Required | Description | |---|---|---|---| | `name` | string | | Drop title, shown at checkout. Falsy values are stored as null. | | `description` | string | | Checked for prohibited words, then discarded — never persisted or displayed. | | `price` | number | yes | USD dollars. 0 = free; otherwise $5–$750. | | `allowDownload` | boolean | | Images only: when true, buyers get a Download button serving a watermarked, metadata-stripped JPEG. Videos always stream behind DRM and are never downloadable. Off unless explicitly set. | | `vaultItemIds` | string[] | yes | 1–10 vault item ids, in display order. The first becomes the cover. | Example — A $25 three-item drop: ```json { "name": "Beach set — 6 photos", "price": 25, "vaultItemIds": [ "clxv1a2b30001item", "clxv1a2b30002item", "clxv1a2b30003item" ] } ``` ## Responses ### 200 Created. Keep the productId — sales polling, previews and post attachment all key on it. | Field | Type | Required | Description | |---|---|---|---| | `productId` | string | yes | The new drop’s id — keep it: check-status, GET /drops/{id}, previews and post attachment all key on it. | | `buyUrl` | string | yes | With an app key: your app’s plain buy link id (`/buy/{linkId}`) — created by POST /drops; reads return it when it exists, else `/buy/{productId}` (a drop your app created still counts for it). With a personal key: `/buy/{productId}`. For a per-fan reference, create a link with POST /api/external/v1/links. | | `linkId` | string \\| null | | The link id in buyUrl (app keys only); comes back as linkId on the sale. | | `mediaCount` | integer | yes | How many vault items were attached. | ```json { "productId": "clxdr0p000001prod", "buyUrl": "https://www.dropfans.io/buy/clxdr0p000001prod", "mediaCount": 3 } ``` ## Errors | Status | Body | When | |---|---|---| | 400 | `{"error":"Invalid price"}` | `price` missing, not a number, NaN or negative. | | 400 | `{"error":"The minimum price is $5. Set the price to free or at least $5."}` | Priced above 0 but below $5. | | 400 | `{"error":"The maximum price on Dropfans is $750. To request an increase, contact support@dropfans.io."}` | Priced above $750. | | 400 | `{"error":"Field \"name\" contains a prohibited word: \"…\"","field":"name","matchedWord":"…"}` | The name or description tripped the word filter — a three-field envelope unique to this endpoint (posts use a two-field 422 for the same class of failure). | | 400 | `{"error":"vaultItemIds must be a non-empty array"}` | Missing or empty media list. | | 400 | `{"error":"Maximum 10 media items allowed per drop"}` | More than 10 ids. | | 400 | `{"error":"Cannot use hidden vault items"}` | One of the items was deleted (hidden). | | 401 | `{"error":"Unauthorized","code":"unauthorized"}` | Missing or invalid API key. | | 403 | `{"error":"You do not own all selected vault items"}` | An id belongs to another creator. | | 404 | `{"error":"One or more vault items not found"}` | An id does not exist. | | 500 | `{"error":"Failed to create drop"}` | Write failed — retry later. | | 400 | `{"error":"X-Dropfans-Account must be an account id (from GET /api/external/agency/creators), not a username.","code":"invalid_account_header"}` | `X-Dropfans-Account` is not an account id. | | 400 | `{"error":"X-Dropfans-Account names a different account than the path — send one or the other.","code":"account_mismatch"}` | Called under /v1/creators/{creatorId}/ with an `X-Dropfans-Account` naming another account. | | 403 | `{"error":"This key cannot act for that account.","code":"account_not_managed"}` | The creator in the path (or `X-Dropfans-Account`) is one this key cannot act for: no ACCEPTED management by your agency and not an account your app onboarded (or it no longer holds a key bound to your app), a key minted for one creator, or someone is suspended, banned or deleted. An unknown id gets the same answer. | | 403 | `{"error":"The agency does not have permission for this on that account.","code":"permission_denied","permission":"canManageDrops"}` | For a managed creator: the agency lacks `canManageDrops` on that account. | | 403 | `{"error":"This app does not have the drops API category enabled. Contact support to enable it.","code":"api_category_disabled","category":"drops"}` | Your app has the Drops & checkout links [API category](https://www.dropfans.io/developers/concepts/api-categories.md) switched off. | ## Notes The drop's moderation status is computed from its media at creation (REJECTED/FLAGGED wins, else PENDING if any item is pending, else APPROVED). Read it back with [GET /api/external/v1/drops/{id}](https://www.dropfans.io/developers/reference/get-drop.md). ## Rate limiting Per-key fixed windows by tier (Personal 60/min · 5,000/day; approved apps 300/min · 50,000/day; Dropfans-operated integrations exempt). Read the live values from X-RateLimit-Tier, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and their -Day variants; a 429 carries Retry-After and `{"error":"Rate limit exceeded","code":"rate_limited"}`. See [Rate limits](https://www.dropfans.io/developers/concepts/rate-limits.md). ## Code samples ### curl ```bash curl -X POST "https://www.dropfans.io/api/external/v1/drops" \ -H "Authorization: Bearer $DROPFANS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Beach set — 6 photos", "price": 25, "vaultItemIds": [ "clxv1a2b30001item", "clxv1a2b30002item", "clxv1a2b30003item" ] }' ``` ### Node ```javascript const res = await fetch(`https://www.dropfans.io/api/external/v1/drops`, { method: 'POST', headers: { Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "name": "Beach set — 6 photos", "price": 25, "vaultItemIds": [ "clxv1a2b30001item", "clxv1a2b30002item", "clxv1a2b30003item" ] }), }); console.log(await res.json()); ``` ### Python ```python import os import requests res = requests.post( "https://www.dropfans.io/api/external/v1/drops", headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"}, json={ "name": "Beach set — 6 photos", "price": 25, "vaultItemIds": [ "clxv1a2b30001item", "clxv1a2b30002item", "clxv1a2b30003item", ], }, ) print(res.json()) ``` ## OpenAPI ```json { "method": "POST", "path": "/api/external/v1/drops", "operationId": "createDrop", "tags": [ "drops" ], "summary": "Create a sellable drop from vault items", "description": "Packages up to 10 vault items into a drop and returns a checkout URL.\n\nPrice is USD **dollars**: either `0` (free) or between $5 and $750. Use APPROVED vault items — the drop inherits its moderation status from its media, so a drop built from approved items is sellable (and attachable to a post) immediately, while one containing PENDING items waits for review. Hand the buyer the returned `buyUrl`, or build a Telegram link from [GET /api/external/v1/links](https://www.dropfans.io/developers/reference/get-links.md)' `telegram.buyTemplate`.\n\n**One drop, many fans.** Don't create a copy per recipient. Create the drop once and give each fan their own link with a reference: `buyUrl?m={yourRef}` on the web, or `startapp=b_{productId}_{yourRef}` in Telegram. The reference comes back on every paid order — see [Broadcast one drop to many fans](https://www.dropfans.io/developers/guides/broadcast-one-drop.md). Different prices still need separate drops.\n\n> [!WARNING] `description` is validated but NOT stored\n> The `description` field runs through the prohibited-word filter and is then deliberately discarded — it is never shown anywhere on Dropfans. You get a 200 with no indication it was dropped. Treat it as a moderation input only.", "parameters": [ { "name": "X-Dropfans-Account", "in": "header", "required": false, "deprecated": true, "description": "Deprecated: call the …ForCreator operation (/api/external/v1/creators/{creatorId}/…) instead; the header keeps working and such responses carry Deprecation and Link: rel=\"successor-version\". With a verified agency’s own key, the id of a creator or AI persona the agency manages (from GET /api/external/v1/agency/creators): the request then acts as that account, exactly as if it were sent with that account’s own key. Account ids only — usernames are refused (400 invalid_account_header). Checked on every request: the management must be ACCEPTED, nobody may be suspended, banned or deleted (else 403 account_not_managed), and the agency needs the endpoint’s permission on that account (else 403 permission_denied). Omit it to act as the key’s own account.", "schema": { "type": "string", "pattern": "^c[a-z0-9]{20,32}$" }, "example": "cmh4v2q8k0003xy9z7w6v5u4t" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "Drop title, shown at checkout. Falsy values are stored as null.", "example": "Beach set — 6 photos" }, "description": { "type": "string", "description": "Checked for prohibited words, then discarded — never persisted or displayed." }, "price": { "type": "number", "description": "USD dollars. 0 = free; otherwise $5–$750.", "example": 25, "minimum": 0, "maximum": 750 }, "allowDownload": { "type": "boolean", "description": "Images only: when true, buyers get a Download button serving a watermarked, metadata-stripped JPEG. Videos always stream behind DRM and are never downloadable. Off unless explicitly set.", "default": false }, "vaultItemIds": { "type": "array", "items": { "type": "string", "description": "A vault item you own." }, "description": "1–10 vault item ids, in display order. The first becomes the cover.", "maxItems": 10 } }, "required": [ "price", "vaultItemIds" ] }, "examples": { "paidDrop": { "summary": "A $25 three-item drop", "value": { "name": "Beach set — 6 photos", "price": 25, "vaultItemIds": [ "clxv1a2b30001item", "clxv1a2b30002item", "clxv1a2b30003item" ] } } } } } }, "responses": { "200": { "description": "Created. Keep the productId — sales polling, previews and post attachment all key on it.", "headers": { "X-RateLimit-Tier": { "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).", "schema": { "type": "string", "enum": [ "personal", "app", "first_party" ] } }, "X-RateLimit-Limit": { "description": "Requests allowed per minute for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left in the current minute window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Epoch seconds when the minute window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit-Day": { "description": "Requests allowed per UTC day for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining-Day": { "description": "Requests left in the current UTC day window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset-Day": { "description": "Epoch seconds when the day window resets.", "schema": { "type": "integer" } }, "X-Dropfans-Account": { "description": "The id of the account this request acted on — the key’s own account, or the managed account named in the X-Dropfans-Account request header. Assert it when acting for several accounts.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string", "description": "The new drop’s id — keep it: check-status, GET /drops/{id}, previews and post attachment all key on it.", "example": "clxdr0p000001prod" }, "buyUrl": { "type": "string", "description": "With an app key: your app’s plain buy link id (`/buy/{linkId}`) — created by POST /drops; reads return it when it exists, else `/buy/{productId}` (a drop your app created still counts for it). With a personal key: `/buy/{productId}`. For a per-fan reference, create a link with POST /api/external/v1/links.", "format": "uri", "example": "https://www.dropfans.io/buy/clxdr0p000001prod" }, "linkId": { "type": [ "string", "null" ], "description": "The link id in buyUrl (app keys only); comes back as linkId on the sale.", "example": "q7m2c8zk4w" }, "mediaCount": { "type": "integer", "description": "How many vault items were attached.", "example": 3 } }, "required": [ "productId", "buyUrl", "mediaCount" ] }, "example": { "productId": "clxdr0p000001prod", "buyUrl": "https://www.dropfans.io/buy/clxdr0p000001prod", "mediaCount": 3 } } } }, "400": { "description": "`price` missing, not a number, NaN or negative. Also: Priced above 0 but below $5. Also: Priced above $750. Also: The name or description tripped the word filter — a three-field envelope unique to this endpoint (posts use a two-field 422 for the same class of failure). Also: Missing or empty media list. Also: More than 10 ids. Also: One of the items was deleted (hidden). Also: `X-Dropfans-Account` is not an account id. Also: Called under /v1/creators/{creatorId}/ with an `X-Dropfans-Account` naming another account.", "headers": { "X-RateLimit-Tier": { "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).", "schema": { "type": "string", "enum": [ "personal", "app", "first_party" ] } }, "X-RateLimit-Limit": { "description": "Requests allowed per minute for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left in the current minute window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Epoch seconds when the minute window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit-Day": { "description": "Requests allowed per UTC day for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining-Day": { "description": "Requests left in the current UTC day window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset-Day": { "description": "Epoch seconds when the day window resets.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Human-readable message describing what went wrong.", "example": "Vault item not found" } }, "required": [ "error" ] }, "example": { "error": "Invalid price" } } } }, "401": { "description": "Missing or invalid API key.", "headers": { "X-RateLimit-Tier": { "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).", "schema": { "type": "string", "enum": [ "personal", "app", "first_party" ] } }, "X-RateLimit-Limit": { "description": "Requests allowed per minute for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left in the current minute window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Epoch seconds when the minute window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit-Day": { "description": "Requests allowed per UTC day for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining-Day": { "description": "Requests left in the current UTC day window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset-Day": { "description": "Epoch seconds when the day window resets.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Human-readable message.", "example": "Rate limit exceeded" }, "code": { "type": "string", "description": "Machine-readable code: unauthorized, app_suspended, first_party_only, api_category_disabled, rate_limited, username_required, invalid_account_header, account_not_managed, permission_denied, account_header_not_allowed, agency_key_required — plus endpoint-specific codes listed on each reference page.", "example": "rate_limited" } }, "required": [ "error", "code" ] }, "example": { "error": "Unauthorized", "code": "unauthorized" } } } }, "403": { "description": "An id belongs to another creator. Also: The creator in the path (or `X-Dropfans-Account`) is one this key cannot act for: no ACCEPTED management by your agency and not an account your app onboarded (or it no longer holds a key bound to your app), a key minted for one creator, or someone is suspended, banned or deleted. An unknown id gets the same answer. Also: For a managed creator: the agency lacks `canManageDrops` on that account. Also: Your app has the Drops & checkout links [API category](https://www.dropfans.io/developers/concepts/api-categories.md) switched off.", "headers": { "X-RateLimit-Tier": { "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).", "schema": { "type": "string", "enum": [ "personal", "app", "first_party" ] } }, "X-RateLimit-Limit": { "description": "Requests allowed per minute for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left in the current minute window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Epoch seconds when the minute window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit-Day": { "description": "Requests allowed per UTC day for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining-Day": { "description": "Requests left in the current UTC day window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset-Day": { "description": "Epoch seconds when the day window resets.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Human-readable message describing what went wrong.", "example": "Vault item not found" } }, "required": [ "error" ] }, "example": { "error": "You do not own all selected vault items" } } } }, "404": { "description": "An id does not exist.", "headers": { "X-RateLimit-Tier": { "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).", "schema": { "type": "string", "enum": [ "personal", "app", "first_party" ] } }, "X-RateLimit-Limit": { "description": "Requests allowed per minute for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left in the current minute window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Epoch seconds when the minute window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit-Day": { "description": "Requests allowed per UTC day for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining-Day": { "description": "Requests left in the current UTC day window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset-Day": { "description": "Epoch seconds when the day window resets.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Human-readable message describing what went wrong.", "example": "Vault item not found" } }, "required": [ "error" ] }, "example": { "error": "One or more vault items not found" } } } }, "429": { "description": "Rate limit exceeded for the current minute or day window. Wait Retry-After seconds and retry.", "headers": { "X-RateLimit-Tier": { "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).", "schema": { "type": "string", "enum": [ "personal", "app", "first_party" ] } }, "X-RateLimit-Limit": { "description": "Requests allowed per minute for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left in the current minute window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Epoch seconds when the minute window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit-Day": { "description": "Requests allowed per UTC day for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining-Day": { "description": "Requests left in the current UTC day window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset-Day": { "description": "Epoch seconds when the day window resets.", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds to wait before retrying (sent with 429s).", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Human-readable message.", "example": "Rate limit exceeded" }, "code": { "type": "string", "description": "Machine-readable code: unauthorized, app_suspended, first_party_only, api_category_disabled, rate_limited, username_required, invalid_account_header, account_not_managed, permission_denied, account_header_not_allowed, agency_key_required — plus endpoint-specific codes listed on each reference page.", "example": "rate_limited" } }, "required": [ "error", "code" ] }, "example": { "error": "Rate limit exceeded", "code": "rate_limited" } } } }, "500": { "description": "Write failed — retry later.", "headers": { "X-RateLimit-Tier": { "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).", "schema": { "type": "string", "enum": [ "personal", "app", "first_party" ] } }, "X-RateLimit-Limit": { "description": "Requests allowed per minute for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left in the current minute window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Epoch seconds when the minute window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit-Day": { "description": "Requests allowed per UTC day for this key (absent on first_party).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining-Day": { "description": "Requests left in the current UTC day window.", "schema": { "type": "integer" } }, "X-RateLimit-Reset-Day": { "description": "Epoch seconds when the day window resets.", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "description": "Human-readable message describing what went wrong.", "example": "Vault item not found" } }, "required": [ "error" ] }, "example": { "error": "Failed to create drop" } } } } }, "x-codeSamples": [ { "lang": "cURL", "label": "curl", "source": "curl -X POST \"https://www.dropfans.io/api/external/v1/drops\" \\\n -H \"Authorization: Bearer $DROPFANS_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"Beach set — 6 photos\",\n \"price\": 25,\n \"vaultItemIds\": [\n \"clxv1a2b30001item\",\n \"clxv1a2b30002item\",\n \"clxv1a2b30003item\"\n ]\n}'" }, { "lang": "JavaScript", "label": "Node", "source": "const res = await fetch(`https://www.dropfans.io/api/external/v1/drops`, {\n method: 'POST',\n headers: {\n Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n \"name\": \"Beach set — 6 photos\",\n \"price\": 25,\n \"vaultItemIds\": [\n \"clxv1a2b30001item\",\n \"clxv1a2b30002item\",\n \"clxv1a2b30003item\"\n ]\n }),\n});\nconsole.log(await res.json());" }, { "lang": "Python", "source": "import os\nimport requests\n\nres = requests.post(\n \"https://www.dropfans.io/api/external/v1/drops\",\n headers={\"Authorization\": f\"Bearer {os.environ['DROPFANS_API_KEY']}\"},\n json={\n \"name\": \"Beach set — 6 photos\",\n \"price\": 25,\n \"vaultItemIds\": [\n \"clxv1a2b30001item\",\n \"clxv1a2b30002item\",\n \"clxv1a2b30003item\",\n ],\n },\n)\nprint(res.json())" } ], "x-dropfans-docs": "https://www.dropfans.io/developers/reference/create-drop", "x-dropfans-category": "drops", "x-dropfans-agency-permission": "canManageDrops" } ``` --- Previous: [Get a media upload](https://www.dropfans.io/developers/reference/get-media-upload.md) · Next: [List the creator’s drops](https://www.dropfans.io/developers/reference/list-drops.md) · All pages: [llms.txt](https://www.dropfans.io/developers/llms.txt)