Billbee

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: Basic auth.
  • Connection: HTTP Basic auth with BILLBEE_USERNAME as the username and BILLBEE_API_PASSWORD as the password.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
BILLBEE_USERNAMEYesBillbee account username (email), used as the HTTP Basic username Docs.
BILLBEE_API_PASSWORDYesBillbee API password set under Settings → API (not the account login password), used as the HTTP Basic password Docs.
BILLBEE_API_KEYYesBillbee developer API key identifying your application, sent in the X-Billbee-Api-Key header (request via [email protected]) Docs.

Setup

  1. Create a Billbee account: Sign up at https://app.billbee.io - a free trial is available for testing.
  2. Activate the API and set an API password: In Billbee open Settings → API (https://app.billbee.io/app_v2/settings/api/general), activate the API module, and set a dedicated API password. This is separate from your account login password.
  3. Request an API key: Email [email protected] with a short note about what you are building to receive a developer API key. This key identifies your application and is sent as the X-Billbee-Api-Key header.
  4. Store the credentials: Add BILLBEE_USERNAME (your Billbee login email), BILLBEE_API_PASSWORD, and BILLBEE_API_KEY to your .env file, then run the List Orders tool to verify access.

Provider notes

  • Every request needs BOTH HTTP Basic auth (username + API password) AND the X-Billbee-Api-Key header
  • Rate limit: max 2 requests per second per API key + user combination; some endpoints have stricter per-call throttles
  • Responses wrap payloads in a Data field alongside Paging and ErrorMessage fields

Provider API reference.

Tools

ToolAccessDescription
List Orders<br /><code className="reference-identifier">billbee__list_orders</code>ReadList orders
Get Order<br /><code className="reference-identifier">billbee__get_order</code>ReadGet order
Update Order State<br /><code className="reference-identifier">billbee__update_order_state</code>WriteUpdate order state
List Products<br /><code className="reference-identifier">billbee__list_products</code>ReadList products
List Customers<br /><code className="reference-identifier">billbee__list_customers</code>ReadList customers
List Invoices<br /><code className="reference-identifier">billbee__list_invoices</code>ReadList invoices
Get Order States<br /><code className="reference-identifier">billbee__get_order_states</code>ReadGet order states
Update Stock<br /><code className="reference-identifier">billbee__update_stock</code>WriteSet stock quantity

Verify the connection

Call a read tool such as billbee__list_orders with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.