For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Getting Started
    • Introduction
    • Getting Started
    • Tia — Operations Assistant
    • Architecture
    • Security Architecture
  • Onboarding & Plans
    • Onboarding Overview
    • Plans & Subscriptions
    • Tia Credits
  • Tenancy & Governance
    • Roles & Members
    • Audit Log
    • Notifications
    • Economic Operators
  • Authoring Studios
    • Content Studio
    • Theme Studio
    • Advanced Studio (Track B)
  • Product Module
    • Products
    • Custom Fields
    • Global Search
    • Identifiers
    • Product Import
    • Bulk Editing
    • Bulk Updates
    • Resolver & GS1 Digital Link
    • GS1 Digital Link Contract
  • Localisations
    • Overview
    • Market Packs
    • Multilingual Content
  • Domains & Custom Hostnames
    • Domain Architecture
    • Resolver Domain Flow
    • Custom Hostname Setup
    • DNS Setup Guide
    • Resolver & Passport Rendering
    • Custom Hostname Lifecycle
    • Troubleshooting
  • Passports
    • Overview
    • Passport Operations
    • Lifecycle States
    • Controlled Update & Break-Glass
    • Content & Templates
    • Themes & Presentation
    • Consumer Experience
    • Publication Lifecycle
    • Brand Setup & Readiness
    • Drafts
  • Passport Intelligence
    • Passport Intelligence
    • Intelligence Overview
    • Scan Visibility
    • Trust Signals
    • Engagement Insights
    • Investigation Timelines
    • Data & Privacy
    • Roadmap
  • Minting
    • Overview
    • Lifecycle
    • Architecture
    • Limits & Performance
    • Token Preview
    • Exports & Print Jobs
    • Carrier Output Profiles
    • Bring-Your-Own Serials
    • Security
    • FAQ
  • API Reference
    • API Credentials Guide
    • API: Credentials
    • API: Products
    • API: Identifiers
    • API: Import
    • API: Batches
    • API: Attachments
    • API: Bulk Updates
    • API: Minting
    • API: Resolver
    • API: Search
        • GETList products
        • POSTCreate product
API ReferenceOpenAPIProducts

Create product

POST
https://api.tieback.io/v1/products
POST
/v1/products
$curl -X POST https://api.tieback.io/v1/products \
>     -H "x-workspace-id: x-workspace-id" \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "name": "EcoSmart Water Bottle",
>  "sku": "ESWB-2024-001",
>  "description": "Reusable water bottle made from recycled materials, 750ml capacity.",
>  "category": "Outdoor Gear",
>  "price": 24.99,
>  "currency": "USD",
>  "stock": 150,
>  "tags": [
>    "eco-friendly",
>    "reusable",
>    "hydration"
>  ]
>}'
201Created
1{
2  "ok": true,
3  "data": {
4    "productId": "a3f1c9e2-7b4d-4f8a-9d3e-2b5f6c7d8e9f",
5    "name": "EcoSmart Water Bottle",
6    "sku": "ESWB-2024-001",
7    "createdAt": "2024-06-10T09:45:00Z",
8    "price": 24.99,
9    "currency": "USD",
10    "stock": 150
11  },
12  "meta": {
13    "requestId": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a",
14    "workspaceId": "f1e2d3c4-b5a6-7890-1234-56789abcdef0"
15  }
16}
Creates a new product in the workspace.
Was this page helpful?
Previous

Start product CSV import

Next
Built with

Authentication

AuthorizationBearer
User session token from tieback authentication
OR
x-api-keystring

Machine-to-machine API key (scoped permissions)

Headers

x-workspace-idstringRequiredformat: "uuid"

Target workspace/brand ID

x-request-idstringOptionalformat: "uuid"

Client-provided correlation ID (auto-generated if missing)

Response

Created
okboolean
dataobject
metaobject