Merchants
- Overview
- Plan Your Dropship Implementation
- Merchant Best Practices
- Integrations
- Orders
- Products
- Suppliers
- Reports
- Settings
- Job Reports
- Support
Merchant API Endpoints
- Authentication in Dropship
- Carriers
- Compliance Reports
- Connection Invites
- Inventory
- Invoices
- Orders
- Products
- Proposals
- Returns
- Shipments
- Webhooks
Suppliers
- Overview
- Getting Started
- Integrations
- Orders
- Products
- Merchants
- Reports
- Settings
Supplier API Endpoints
- Authentication in Dropship
- Connections
- Inventory
- Orders
- Products
- Proposals
- Returns
- Webhooks
Proposals
Mark a proposal as complete
PUT
/
v1
/
retailers
/
{retailer_id}
/
proposals
/
{id}
/
complete
/
Copy
Ask AI
curl --request PUT \
--url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/proposals/{id}/complete/ \
--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."
}'
Copy
Ask AI
{
"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"
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The unique retailer ID. In the Dropship UI this is called the Merchant ID. To find your Merchant ID, click your merchant name in the top nav.
Example:
1001
The unique identifier of the proposal. This ID is automatically generated when a proposal is created.
Body
application/json
Response
200 - application/json
Proposal details
The response is of type object
.
Was this page helpful?
Copy
Ask AI
curl --request PUT \
--url https://marketplace-api.fabric.inc/v1/retailers/{retailer_id}/proposals/{id}/complete/ \
--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."
}'
Copy
Ask AI
{
"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"
}
Assistant
Responses are generated using AI and may contain mistakes.