# Bob Shop Tools API Documentation

> The Bob Shop Tools API lets you list your products on Bob Shop from your own system, keep them up to date one at a time or in bulk, and receive each paid order at a webhook URL. Base URLs: sandbox `https://api.tools.qa.bobshop.co.za`, production `https://api.tools.bobshop.co.za`.

Every page is also available as plain Markdown by appending `.md` to its URL path.

## Introduction

- [Bob Shop Tools API](/introduction.md): The Bob Shop Tools API lets your own system manage your Bob Shop listings through an API source on Bob Sync.

## Authentication

- [Authentication](/authentication.md): Every request carries a bearer token.

## Workflow

- [Workflow](/workflow.md): The integration in order, from a new account to orders arriving.

## What makes a product go live

- [What makes a product go live](/what-makes-a-product-go-live.md): A 200 means we stored the product.

## Important concepts

- [Important concepts](/important-concepts.md): Two identifiers matter, and they are not interchangeable.

## Products

- [Products](/products.md): Create, read, update and delete products one at a time.
- [GET Fetch products](/products/product-fetch.md): Retrieve one or more of your products by our numeric id.
- [POST Create or update a product](/products/product-upsert.md): Send the product without an id to create it.
- [DELETE Delete a product](/products/product-delete.md): Delete a product.

## Bulk upload

- [Bulk upload](/bulk-upload.md): Send many products at once, without the request body limit of a single upsert (1 MB on Sandbox, 6 MB on Production).
- [GET Get a bulk upload URL](/bulk-upload/bulk-upload-url.md): Returns a signed URL, valid for 7 days.
- [POST Start a bulk upload](/bulk-upload/bulk-upload-start.md): Queue a previously uploaded bulk file for processing.
- [GET Check bulk upload status](/bulk-upload/bulk-upload-status.md): How a bulk upload is progressing, or how the last one finished.
- [POST Cancel a bulk upload](/bulk-upload/bulk-upload-cancel.md): Stop a bulk upload that is currently running.
- [Bulk file format](/bulk-upload/bulk-file-format.md): A JSON array of products, each in the same format as a single upsert.

## Webhooks

- [Webhooks](/webhooks.md): When your API source is set up we ask you for a webhook delivery URL.
- [Order created](/webhooks/order-created.md): Sent when one of your Bob Shop orders is paid.

## Optional

- [Complete documentation in a single file](/llms-full.txt)