Create a Catalog product

POST

catalog

cURL

curl --request POST \
  --url https://app.productlasso.com/api/v1/catalog \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    "attributes": {"sku": "A-100", "product_name": "Alpine bottle", "price": 24.9},
    "attribute_extension_ids": ["e683267d-2450-4ea8-a977-462d46a8f610"]
  }'

const response = await fetch("https://app.productlasso.com/api/v1/catalog", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    schema_id: "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    attributes: { sku: "A-100", product_name: "Alpine bottle", price: 24.9 },
    attribute_extension_ids: ["e683267d-2450-4ea8-a977-462d46a8f610"],
  }),
});

if (!response.ok) throw new Error(await response.text());
const product = await response.json();

import os
import requests

response = requests.post(
    "https://app.productlasso.com/api/v1/catalog",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
        "attributes": {"sku": "A-100", "product_name": "Alpine bottle", "price": 24.9},
        "attribute_extension_ids": ["e683267d-2450-4ea8-a977-462d46a8f610"],
    },
    timeout=30,
)
response.raise_for_status()
product = response.json()

{
  "id": "13adf145-d9a0-4c28-9235-3f7e17af4cf1",
  "company_id": "81e2b625-e6e8-4dd5-a50f-22803806cc10",
  "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
  "source": "manual",
  "external_id": null,
  "status": "draft",
  "attributes": {
    "sku": "A-100",
    "product_name": "Alpine bottle",
    "price": 24.9
  },
  "attribute_extensions": [
    {
      "attribute_id": "e683267d-2450-4ea8-a977-462d46a8f610",
      "key": "supplier_note"
    }
  ],
  "created_at": "2026-08-31T09:30:00.000Z",
  "updated_at": "2026-08-31T09:30:00.000Z",
  "deleted_at": null
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

Usage notes

schema_id selects the product’s reusable Product Schema.
Keys in attributes must resolve to active Attributes in that schema or in attribute_extension_ids.
attribute_extension_ids attaches existing company Attributes to this product only. It does not add them to the reusable Product Schema.
Relation values and Attribute values are validated before the product is created. A validation failure creates nothing.

New API-created products use the handler’s default source and lifecycle state; inspect the returned source and status instead of assuming them.

Examples

curl --request POST \
  --url https://app.productlasso.com/api/v1/catalog \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    "attributes": {"sku": "A-100", "product_name": "Alpine bottle", "price": 24.9},
    "attribute_extension_ids": ["e683267d-2450-4ea8-a977-462d46a8f610"]
  }'

const response = await fetch("https://app.productlasso.com/api/v1/catalog", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    schema_id: "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    attributes: { sku: "A-100", product_name: "Alpine bottle", price: 24.9 },
    attribute_extension_ids: ["e683267d-2450-4ea8-a977-462d46a8f610"],
  }),
});

if (!response.ok) throw new Error(await response.text());
const product = await response.json();

import os
import requests

response = requests.post(
    "https://app.productlasso.com/api/v1/catalog",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
        "attributes": {"sku": "A-100", "product_name": "Alpine bottle", "price": 24.9},
        "attribute_extension_ids": ["e683267d-2450-4ea8-a977-462d46a8f610"],
    },
    timeout=30,
)
response.raise_for_status()
product = response.json()

Example response

{
  "id": "13adf145-d9a0-4c28-9235-3f7e17af4cf1",
  "company_id": "81e2b625-e6e8-4dd5-a50f-22803806cc10",
  "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
  "source": "manual",
  "external_id": null,
  "status": "draft",
  "attributes": {"sku": "A-100", "product_name": "Alpine bottle", "price": 24.9},
  "attribute_extensions": [
    {"attribute_id": "e683267d-2450-4ea8-a977-462d46a8f610", "key": "supplier_note"}
  ],
  "created_at": "2026-08-31T09:30:00.000Z",
  "updated_at": "2026-08-31T09:30:00.000Z",
  "deleted_at": null
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

schema_id

string<uuid>

required

attributes

object

required

attribute_extension_ids

string<uuid>[]

Active Shared Attribute UUIDs to attach only to this product. Attributes already owned by the base schema remain schema fields and are not duplicated here.

Maximum array length: 2000

Response

Catalog product created.

string<uuid>

required

company_id

string<uuid>

required

schema_id

string<uuid>

required

source

enum<string>

required

Available options:

manual,

product_extraction,

shopify

external_id

string | null

required

status

enum<string>

required

Available options:

draft,

active,

archived

attributes

object

required

Values backed by active Shared Attributes from the base schema or attribute_extensions.

attribute_extensions

object[]

required

Maximum array length: 2000

Show child attributes

created_at

string<date-time>

required

updated_at

string<date-time>

required

deleted_at

string<date-time> | null

required

relations

object

Hydrated relation values. Present on the single-product GET response.

cURL

curl --request POST \
  --url https://app.productlasso.com/api/v1/catalog \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    "attributes": {"sku": "A-100", "product_name": "Alpine bottle", "price": 24.9},
    "attribute_extension_ids": ["e683267d-2450-4ea8-a977-462d46a8f610"]
  }'

const response = await fetch("https://app.productlasso.com/api/v1/catalog", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    schema_id: "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
    attributes: { sku: "A-100", product_name: "Alpine bottle", price: 24.9 },
    attribute_extension_ids: ["e683267d-2450-4ea8-a977-462d46a8f610"],
  }),
});

if (!response.ok) throw new Error(await response.text());
const product = await response.json();

import os
import requests

response = requests.post(
    "https://app.productlasso.com/api/v1/catalog",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
        "attributes": {"sku": "A-100", "product_name": "Alpine bottle", "price": 24.9},
        "attribute_extension_ids": ["e683267d-2450-4ea8-a977-462d46a8f610"],
    },
    timeout=30,
)
response.raise_for_status()
product = response.json()

{
  "id": "13adf145-d9a0-4c28-9235-3f7e17af4cf1",
  "company_id": "81e2b625-e6e8-4dd5-a50f-22803806cc10",
  "schema_id": "9e1c77dd-8f10-41ca-bfe8-e672b89692d1",
  "source": "manual",
  "external_id": null,
  "status": "draft",
  "attributes": {
    "sku": "A-100",
    "product_name": "Alpine bottle",
    "price": 24.9
  },
  "attribute_extensions": [
    {
      "attribute_id": "e683267d-2450-4ea8-a977-462d46a8f610",
      "key": "supplier_note"
    }
  ],
  "created_at": "2026-08-31T09:30:00.000Z",
  "updated_at": "2026-08-31T09:30:00.000Z",
  "deleted_at": null
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

Overview

Search

Enrich

Tables

Rows

Enhance

Schemas

Attributes

Files

Glossary

Credits

Product analytics

Catalog

Catalog Webhooks

Create a Catalog product

Usage notes

Examples

Authorizations

Body

Response

​Usage notes

​Examples

Authorizations

Body

Response

Usage notes

Examples