curl --request POST \
--url https://marketplace-api.fabric.inc/v1/brands/{brand_id}/proposals/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Eco-Friendly Tumbler Set",
"status": "draft",
"source": "console",
"proposal_type": "new_product",
"return_reason_detail": "Incorrect pricing on listed item.",
"push_to_shopify": true,
"end_at": "2025-06-30T23:59:59Z",
"item_skipped_count": 3,
"has_price_changes": false,
"target_live_date": "2025-07-01T00:00:00Z",
"start_at": "2025-05-01T00:00:00Z",
"expires_at": "2025-07-31T23:59:59Z",
"draft_proposed_at": "2025-04-20T12:00:00Z",
"acknowledged_at": "2025-04-22T09:00:00Z",
"proposed_at": "2025-04-23T10:00:00Z",
"archived_at": "2025-08-01T10:00:00Z",
"revised_at": "2025-04-25T15:00:00Z",
"approved_at": "2025-05-01T10:00:00Z",
"declined_at": "2025-05-02T12:00:00Z",
"pricing_approved_at": "2025-05-03T14:00:00Z",
"completed_at": "2025-05-05T16:00:00Z",
"withdrawn_at": "2025-05-06T09:30:00Z",
"withdraw_reason": "Vendor no longer supports product line."
}'
{
"id": 101,
"name": "Winter 2025 Collection Update",
"status": "proposed",
"source": "console",
"proposal_type": "new_product",
"recipient": "retailer_456",
"sender": "supplier_123",
"memos": "Initial draft submitted by merchandising team.",
"created_by": "user_789",
"connection": "integration_abc",
"retailer": "Fashion Retail Co.",
"brand": "FrostWear",
"department": "Apparel",
"return_reason": "Insufficient pricing justification",
"return_reason_detail": "Missing supplier cost comparison documentation.",
"products": "[{ product_id: 202, name: 'Arctic Parka' }]",
"push_to_shopify": true,
"shopify_template": "default_fashion_template",
"export_platform_template": "standard_export_v1",
"attachments": "[{ filename: 'lookbook.pdf' }]",
"end_at": "2025-09-30T23:59:59Z",
"issues_summary": "Missing product images for 3 items",
"is_acknowledged": false,
"item_approved_count": 5,
"item_deleted_count": 0,
"item_rejected_count": 1,
"item_skipped_count": 2,
"item_count": "10",
"item_classified_count": "8",
"item_ready_count": "6",
"item_failed_count": "1",
"action_required": "Upload missing product photos",
"has_action": "yes",
"has_revision": "true",
"has_unresolved_issues": true,
"has_price_changes": true,
"collaborators": "user_789, user_321",
"target_live_date": "2025-10-01T00:00:00Z",
"start_at": "2025-04-01T00:00:00Z",
"expires_at": "2025-06-01T00:00:00Z",
"updated_at": "2025-04-22T15:30:00Z",
"created_at": "2025-04-20T08:45:00Z",
"draft_proposed_at": "2025-04-10T12:00:00Z",
"acknowledged_at": "2025-04-15T09:30:00Z",
"proposed_at": "2025-04-20T10:00:00Z",
"archived_at": "2025-04-22T17:00:00Z",
"revised_at": "2025-04-21T14:15:00Z",
"approved_at": "2025-04-25T11:00:00Z",
"declined_at": "2025-04-26T10:30:00Z",
"pricing_approved_at": "2025-04-24T13:45:00Z",
"completed_at": "2025-04-28T16:00:00Z",
"withdrawn_at": "2025-04-27T08:00:00Z",
"withdraw_reason": "The product line was discontinued by the supplier.",
"tags": "seasonal,featured,high-priority"
}
Use the create proposal endpoint to initiate a new, empty draft proposal. This draft will subsequently be enriched with your product data once the file is received
curl --request POST \
--url https://marketplace-api.fabric.inc/v1/brands/{brand_id}/proposals/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Eco-Friendly Tumbler Set",
"status": "draft",
"source": "console",
"proposal_type": "new_product",
"return_reason_detail": "Incorrect pricing on listed item.",
"push_to_shopify": true,
"end_at": "2025-06-30T23:59:59Z",
"item_skipped_count": 3,
"has_price_changes": false,
"target_live_date": "2025-07-01T00:00:00Z",
"start_at": "2025-05-01T00:00:00Z",
"expires_at": "2025-07-31T23:59:59Z",
"draft_proposed_at": "2025-04-20T12:00:00Z",
"acknowledged_at": "2025-04-22T09:00:00Z",
"proposed_at": "2025-04-23T10:00:00Z",
"archived_at": "2025-08-01T10:00:00Z",
"revised_at": "2025-04-25T15:00:00Z",
"approved_at": "2025-05-01T10:00:00Z",
"declined_at": "2025-05-02T12:00:00Z",
"pricing_approved_at": "2025-05-03T14:00:00Z",
"completed_at": "2025-05-05T16:00:00Z",
"withdrawn_at": "2025-05-06T09:30:00Z",
"withdraw_reason": "Vendor no longer supports product line."
}'
{
"id": 101,
"name": "Winter 2025 Collection Update",
"status": "proposed",
"source": "console",
"proposal_type": "new_product",
"recipient": "retailer_456",
"sender": "supplier_123",
"memos": "Initial draft submitted by merchandising team.",
"created_by": "user_789",
"connection": "integration_abc",
"retailer": "Fashion Retail Co.",
"brand": "FrostWear",
"department": "Apparel",
"return_reason": "Insufficient pricing justification",
"return_reason_detail": "Missing supplier cost comparison documentation.",
"products": "[{ product_id: 202, name: 'Arctic Parka' }]",
"push_to_shopify": true,
"shopify_template": "default_fashion_template",
"export_platform_template": "standard_export_v1",
"attachments": "[{ filename: 'lookbook.pdf' }]",
"end_at": "2025-09-30T23:59:59Z",
"issues_summary": "Missing product images for 3 items",
"is_acknowledged": false,
"item_approved_count": 5,
"item_deleted_count": 0,
"item_rejected_count": 1,
"item_skipped_count": 2,
"item_count": "10",
"item_classified_count": "8",
"item_ready_count": "6",
"item_failed_count": "1",
"action_required": "Upload missing product photos",
"has_action": "yes",
"has_revision": "true",
"has_unresolved_issues": true,
"has_price_changes": true,
"collaborators": "user_789, user_321",
"target_live_date": "2025-10-01T00:00:00Z",
"start_at": "2025-04-01T00:00:00Z",
"expires_at": "2025-06-01T00:00:00Z",
"updated_at": "2025-04-22T15:30:00Z",
"created_at": "2025-04-20T08:45:00Z",
"draft_proposed_at": "2025-04-10T12:00:00Z",
"acknowledged_at": "2025-04-15T09:30:00Z",
"proposed_at": "2025-04-20T10:00:00Z",
"archived_at": "2025-04-22T17:00:00Z",
"revised_at": "2025-04-21T14:15:00Z",
"approved_at": "2025-04-25T11:00:00Z",
"declined_at": "2025-04-26T10:30:00Z",
"pricing_approved_at": "2025-04-24T13:45:00Z",
"completed_at": "2025-04-28T16:00:00Z",
"withdrawn_at": "2025-04-27T08:00:00Z",
"withdraw_reason": "The product line was discontinued by the supplier.",
"tags": "seasonal,featured,high-priority"
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
The unique brand ID. In the Dropship UI this is called the Supplier ID. To find your Supplier ID, click your supplier name in the top nav.
OK
The response is of type object
.
Was this page helpful?