---
title: "Create Order"
method: POST
path: "/api/fiverr/accounts/{account_id}/orders"
tags: ["fiverr"]
---

# Create Order

`POST /api/fiverr/accounts/{account_id}/orders`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/fiverr/accounts/{account_id}/orders`
- Auth: HTTP bearer

Record a new order discovered by inbox poll.

Idempotent on ``fiverr_order_id`` (the platform-issued FO123ABC). Repeated
POSTs for the same order_id return the existing row instead of 409 — the
polling loop is not transactional, so dedup belongs server-side.

## Path parameters

- `account_id` string, uuid, required

## Request body

- FiverrOrderCreate: Internal-only — the bot writes orders as it discovers them on Fiverr. Mirrors the dashboard's view of the order, not anything the owner submits directly.
  - `fiverr_order_id` string, required
  - `gig_id` string, uuid, required
  - `buyer_handle` string, required
  - `buyer_brief` string, nullable
  - `package_tier` string, nullable
  - `total_price_cents` integer
  - `state` 'inquiry_received' | 'quote_drafted' | 'quote_sent' | 'order_received' | 'order_accepted' | 'in_progress' | 'delivered' | 'revision_requested' | 'completed' | 'canceled' | 'disputed'
  - `due_at` string, date-time, nullable

## Response `201`

Successful Response

- FiverrOrderResponse
  - `id` string, uuid, required
  - `fiverr_order_id` string, required
  - `gig_id` string, uuid, required
  - `account_id` string, uuid, required
  - `buyer_handle` string, required
  - `buyer_brief` string, nullable
  - `package_tier` string, nullable
  - `total_price_cents` integer, required
  - `state` 'inquiry_received' | 'quote_drafted' | 'quote_sent' | 'order_received' | 'order_accepted' | 'in_progress' | 'delivered' | 'revision_requested' | 'completed' | 'canceled' | 'disputed', required
  - `due_at` string, date-time, nullable
  - `delivered_at` string, date-time, nullable
  - `revision_count` integer, required
  - `deliverable_s3_key` string, nullable
  - `conversation_id` string, uuid, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)