Duplicate Inbound Plan
POST/api/tiktok-shop/:integrationInstance/fbt/inbound-plans/:plan/duplicate
Copy an inbound plan into a fresh draft — the "same shipment again next month" path. Takes no body.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Only the intent is copied: the source, the splitting mode and every line (product, shop SKU, goods id, quantity, prep instructions, prep owner, kit source). The TikTok plan id, the idempotency reference, the placement options and every lifecycle timestamp are deliberately not copied — a duplicate carrying the original's reference would be adopted by the original at TikTok instead of creating anything. Cartons are not copied either.
Returns 201 with the new draft.
The plan must belong to the integration instance in the path; a plan owned by another instance answers 404.
Requires the integrations.update permission.
Request
Responses
- 201
- 401
- 403
- 404
- 422
- 429
Created
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.