# BrandGate API

> Connect ERP systems, partner software and AI assistants to BrandGate: orders, products, stock, customers and invoices.

- [BrandGate API](https://docs.brandgate.dev/introduction.md): Connect your ERP, partner software and AI assistants to BrandGate.
- [Quickstart](https://docs.brandgate.dev/quickstart.md): Create an API key and read your first orders.
- [API keys and scopes](https://docs.brandgate.dev/authentication.md): Authenticate your own integration with an API key.
- [OAuth for partners](https://docs.brandgate.dev/oauth.md): Let any BrandGate customer connect your product with one click.
- [Sync an ERP](https://docs.brandgate.dev/guides/erp-sync.md): The recommended loop for orders, stock and invoices.
- [Webhooks](https://docs.brandgate.dev/webhooks.md): Get a signed HTTPS request when something changes.
- [MCP server](https://docs.brandgate.dev/mcp.md): Use BrandGate from Claude, ChatGPT, Cursor and other AI assistants.
- [Pagination](https://docs.brandgate.dev/pagination.md): Walk through lists with a cursor.
- [Errors](https://docs.brandgate.dev/errors.md): Every error has the same shape and a stable code.
- [Rate limits](https://docs.brandgate.dev/rate-limits.md): Generous limits, announced in every response.
- [Versioning](https://docs.brandgate.dev/versioning.md): What we change, and what we promise not to break.
- [List orders](https://docs.brandgate.dev/api-reference/orders/list-orders.md): Orders oldest change first. Use updated_since and the cursor to sync changes.
- [Get an order](https://docs.brandgate.dev/api-reference/orders/get-an-order.md): One order with its lines and any ERP acknowledgement.
- [Acknowledge an order](https://docs.brandgate.dev/api-reference/orders/acknowledge-an-order.md): Record the order's number in your ERP. Repeating the same number is safe; a different number for an acknowledged order is refused.
- [List products](https://docs.brandgate.dev/api-reference/products/list-products.md): Products oldest change first.
- [Get a product](https://docs.brandgate.dev/api-reference/products/get-a-product.md): One product.
- [List stock levels](https://docs.brandgate.dev/api-reference/inventory/list-stock-levels.md): Stock per product SKU, oldest change first.
- [Set stock levels](https://docs.brandgate.dev/api-reference/inventory/set-stock-levels.md): Set absolute stock per SKU (up to 500 per request). The ERP is the source of truth: BrandGate stock is overwritten, not added to. Answers 409 inventory_managed_by_erp when the company already imports stock from an ERP connected in BrandGate.
- [List customers](https://docs.brandgate.dev/api-reference/customers/list-customers.md): Resellers buying from the organization, oldest change first.
- [Get a customer](https://docs.brandgate.dev/api-reference/customers/get-a-customer.md): One reseller.
- [List invoices](https://docs.brandgate.dev/api-reference/invoices/list-invoices.md): Invoices oldest change first.
- [Get an invoice](https://docs.brandgate.dev/api-reference/invoices/get-an-invoice.md): One invoice with its lines.
- [List webhook endpoints](https://docs.brandgate.dev/api-reference/webhook_endpoints/list-webhook-endpoints.md): The organization's webhook endpoints.
- [Create a webhook endpoint](https://docs.brandgate.dev/api-reference/webhook_endpoints/create-a-webhook-endpoint.md): Events are delivered only for scopes the caller holds. The signing secret is returned once.
- [Delete a webhook endpoint](https://docs.brandgate.dev/api-reference/webhook_endpoints/delete-a-webhook-endpoint.md): Stops deliveries to the endpoint.
- [Ordercreated](https://docs.brandgate.dev/api-reference/ordercreated.md): Sent when order is created. Verify the `BrandGate-Signature` header, then fetch the object for its current state.
- [Orderupdated](https://docs.brandgate.dev/api-reference/orderupdated.md): Sent when order is updated. Verify the `BrandGate-Signature` header, then fetch the object for its current state.
- [Invoicecreated](https://docs.brandgate.dev/api-reference/invoicecreated.md): Sent when invoice is created. Verify the `BrandGate-Signature` header, then fetch the object for its current state.
- [Invoiceupdated](https://docs.brandgate.dev/api-reference/invoiceupdated.md): Sent when invoice is updated. Verify the `BrandGate-Signature` header, then fetch the object for its current state.
- [Productstock low](https://docs.brandgate.dev/api-reference/productstock_low.md): Sent when product is stock low. Verify the `BrandGate-Signature` header, then fetch the object for its current state.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.