Qonto

Consume Qonto API

Actions46

Attachment Actions
- Upload Attachment
- Show Attachment
Attachments in a Transaction Actions
Beneficiary Actions
Card Actions
Client Actions
Client Invoice Actions
Credit Note Actions
- Get a List of Credit Notes for an Organization
- Get Details of Credit Note for an Organization
External Transfer Actions
Insurance Contract Actions
Internal Transaction Actions
- Create Internal Transfer
Label Actions
- List Labels
- Show Label
Membership Actions
Organization Actions
- Get Organization and Its Bank_accounts
Request Actions
Statement Actions
- Show Statement
- List Statements
Supplier Invoice Actions
- Get a List of Supplier Invoices for an Organization
- Create Supplier Invoices with Attachments
Team Actions
- List Teams in an Organization
- Create a New Team
Transaction Actions
- List Transactions
- Show Transaction

Overview

This node integrates with the Qonto API to manage insurance contracts within an organization. Specifically, for the "Insurance Contract" resource and the "Create a New Insurance Contract" operation, it allows users to create new insurance contracts by providing necessary details such as contract name, start date, optional end date, and coverage details.

Common scenarios where this node is beneficial include automating the creation of insurance contracts when onboarding new clients or updating organizational records in financial workflows. For example, a company could use this node to automatically register new insurance contracts in Qonto whenever a new policy is sold or updated in their CRM system.

Properties

Name	Meaning
Authentication	Method of authentication to use: "Login and Secret-Key" or "OAuth2".
Organization ID	The unique identifier of the organization creating the insurance contract (required).
Contract Name	The name/title of the insurance contract (required).
Start Date	The start date of the insurance contract (required).
End Date	The end date of the insurance contract (optional).
Coverage Details	Additional details describing the coverage provided by the insurance contract (optional).

Output

The node outputs JSON data representing the newly created insurance contract as returned by the Qonto API. This typically includes fields such as the contract's unique ID, name, start and end dates, coverage details, and any other metadata provided by the API response.

No binary data output is produced by this operation.

Dependencies

Requires access to the Qonto API.
Requires either an API key credential ("Login and Secret-Key") or OAuth2 authentication configured in n8n.
The node uses UUID generation internally to handle idempotency keys for some operations, but not specifically for creating insurance contracts.
Proper configuration of credentials and permissions in Qonto is necessary to create insurance contracts.

Troubleshooting

Authentication errors: Ensure that the selected authentication method is correctly configured with valid credentials or tokens.
Missing required fields: The operation requires Organization ID, Contract Name, and Start Date. Omitting these will likely cause API errors.
API rate limits or network issues: These can cause request failures; check connectivity and Qonto API status.
Invalid date formats: Dates must be in a valid ISO 8601 format; invalid formats may cause errors.
Permission denied: The authenticated user must have permission to create insurance contracts in the specified organization.

Links and References

Qonto API Documentation - Insurance Contracts
n8n Documentation - Creating Custom Nodes
UUID npm package (used internally for idempotency keys)