Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

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.
  • 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: https://docs.qonto.com

Tools

Example prompts

  • Show my Qonto bank accounts with their current and authorized balances.
  • List the most recent completed transactions on my main Qonto account and summarize debits vs credits.
  • Find recent Qonto transactions that have no attachment so I can chase missing receipts.