Qonto

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

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from QONTO_API_KEY is sent as the Authorization header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
QONTO_API_KEYYesQonto API credential in the form organization-slug:secret-key - your organization slug (login) and API secret key joined by a colon. Sent as the raw Authorization header value (no Bearer prefix, no Base64 encoding). Docs.

Setup

  1. Open your Qonto organization: Log in to the Qonto web app at https://app.qonto.com. For testing without a live account, create a sandbox organization through the Qonto Developer Portal toolkit at https://developers.qonto.com.
  2. Generate an API key: In the web app, go to Integrations and Partnerships > API key and click Generate. Note both your organization slug (the login, e.g. my-company-1234) and the generated secret key.
  3. Set the environment variable: Set QONTO_API_KEY to the organization slug and secret key joined by a colon, e.g. my-company-1234:62885d39f3a0ddedd3d3ee0432a43ccr. The value is sent as-is in the Authorization header - no Bearer prefix and no Base64 encoding.
  4. Verify access: Run Get Organization. A successful response confirms the credential; a 401 means the Authorization value is malformed.

Provider notes

  • The Authorization header is the raw 'organization-slug:secret-key' string - unlike most APIs there is no Bearer prefix and no encoding.
  • This connector targets the production API (thirdparty.qonto.com/v2). The sandbox uses a different host (thirdparty-sandbox.staging.qonto.co) and additionally requires an X-Qonto-Staging-Token header.
  • Uploading an attachment to a transaction (POST /v2/transactions/{id}/attachments) requires a multipart/form-data file part, which this connector's JSON endpoint executor does not support yet - only listing attachments is included.

Provider API reference.

Tools

ToolAccessDescription
Get Organization<br /><code className="reference-identifier">qonto__get_organization</code>ReadGet organization
List Transactions<br /><code className="reference-identifier">qonto__list_transactions</code>ReadList transactions
Get Transaction<br /><code className="reference-identifier">qonto__get_transaction</code>ReadGet transaction
List Transaction Attachments<br /><code className="reference-identifier">qonto__list_transaction_attachments</code>ReadList transaction attachments
Upload Transaction Attachment<br /><code className="reference-identifier">qonto__upload_transaction_attachment</code>WriteStart transaction attachment upload
Get Attachment<br /><code className="reference-identifier">qonto__get_attachment</code>ReadGet attachment with expiring download URL
List Supplier Invoices<br /><code className="reference-identifier">qonto__list_supplier_invoices</code>ReadList supplier invoices

Verify the connection

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