> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Product Listing

> Publish a product to your app's sales channel

Publishes a product to your app's
[sales channel](/api-reference/sales-channels/create). Create the sales
channel first — the listing is attached to the channel resolved from your app
identity.

**Auth:** OAuth access token with the `write_products` scope.

## Body Parameters

<ParamField body="product_id" type="string" required>
  The product to publish. Accepts the product UUID (`product_id`) or its
  numeric id.
</ParamField>

<ParamField body="external_id" type="string">
  The product's id on the external channel, if you're mirroring it. Stored and
  returned as-is.
</ParamField>

## Request

```json theme={null}
{
  "product_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
  "external_id": "fb_prod_98765"
}
```

## Response

```json theme={null}
{
  "product_listing": {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "product_id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
    "external_id": "fb_prod_98765",
    "status": "active"
  }
}
```

## Errors

| Status | Body                          | Cause                                             |
| ------ | ----------------------------- | ------------------------------------------------- |
| `400`  | `{ errors: { base: [...] } }` | `product_id` missing or the product wasn't found. |
| `403`  | `{ errors: { base: [...] } }` | Token lacks the `write_products` scope.           |