> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pennylane

> Connect Pennylane to your Atako agents — 13 read and 1 write actions.

Let your agents manage customers, suppliers, invoices, products and categories on your Pennylane account.

## Connection

* **Authentication**: API key (Company API token).

<Note>
  Pennylane → Settings → Connectivity → Developers → Generate an API Token. Choose a name, select the required scopes (customers:readonly, suppliers:readonly, customer\_invoices:readonly, supplier\_invoices:readonly, products:readonly, categories:readonly; add :all for write actions), and copy the token.

  See [Pennylane's documentation](https://app.pennylane.com/settings/connectivity/developers).
</Note>

## Read actions (13)

| Action                   | Description                                                                                                                                                    |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_category`           | Retrieve a category by ID.                                                                                                                                     |
| `get_customer`           | Retrieve a customer by ID.                                                                                                                                     |
| `get_customer_invoice`   | Retrieve a customer invoice or credit note by ID.                                                                                                              |
| `get_product`            | Retrieve a product by ID.                                                                                                                                      |
| `get_profile`            | Retrieve the current user profile and company info. No specific scope required.                                                                                |
| `get_supplier`           | Retrieve a supplier by ID.                                                                                                                                     |
| `get_supplier_invoice`   | Retrieve a supplier invoice by ID.                                                                                                                             |
| `list_categories`        | List analytical categories. Supports cursor-based pagination.                                                                                                  |
| `list_customer_invoices` | List customer invoices and credit notes. Supports cursor-based pagination. Use the filter query param (JSON array of \{field, operator, value}) for filtering. |
| `list_customers`         | List company and individual customers. Supports cursor-based pagination.                                                                                       |
| `list_products`          | List products. Supports cursor-based pagination.                                                                                                               |
| `list_supplier_invoices` | List supplier invoices. Supports cursor-based pagination. Use the filter query param (JSON array of \{field, operator, value}) for filtering.                  |
| `list_suppliers`         | List suppliers. Supports cursor-based pagination.                                                                                                              |

## Write actions (1)

| Action            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `create_customer` | Create a company customer. Arguments: name (string, required — company name), billing\_address (object with address, postal\_code, city, country\_alpha2 — all strings, required), delivery\_address (object, optional), emails (array of strings, optional), phone (string, optional), vat\_number (string, optional), reg\_no (string, optional), recipient (string, optional — invoicing contact name), reference (string, optional), notes (string, optional), billing\_iban (string, optional), payment\_conditions (enum string: upon\_receipt\|custom\|7\_days\|15\_days\|30\_days\|30\_days\_end\_of\_month\|45\_days\|45\_days\_end\_of\_month\|60\_days, optional), billing\_language (enum string: fr\_FR\|en\_GB\|de\_DE\|es\_ES, optional), external\_reference (string, optional). |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.