Skip to main content
POST
Record a partner event

Authorizations

Authorization
string
header
required

Bearer authorization header: Bearer <token>. To get your <token>, please sign up to the Developer Portal.

Qonto-Partner-Id
string
header
required

API Key authorization header: Qonto-Partner-Id: <partner_id>. To get your <partner_id> please, sign up to the Developer Portal.

Headers

X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Body

application/json
organization_id
string<uuid>
required

Qonto organization ID. Required unless registration_id is provided.

Example:

"6367b150-ce8c-40c4-8e0a-5535119fde70"

event
enum<string>
required

ITAdvisors event name. Other partner codes or undeclared event names are rejected.

Available options:
incorporation_flow_started,
incorporation_legal_form_filled,
incorporation_pricing_seen,
incorporation_invoicing_info_filled,
incorporation_checkout_clicked,
incorporation_payment_completed,
incorporation_accountant_booked,
incorporation_accountant_completed,
incorporation_vat_submitted,
incorporation_vat_completed
Example:

"incorporation_flow_started"

occurred_at
string<date-time>
required

Timestamp when the event occurred, with timezone.

Example:

"2026-09-23T10:00:00Z"

registration_id
string<uuid>

Partner registration ID. May be sent with organization_id if both identify the same organization.

Example:

"01959094-8699-7b6c-b0e6-9cd728890843"

Response

Event recorded or an existing event updated idempotently.