> ## Documentation Index > Fetch the complete documentation index at: https://kavenio.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Send conversion events > Sends conversion events to a configured provider conversion destination. ## OpenAPI ````yaml /api/openapi.json post /v1/ads/conversions openapi: 3.1.0 info: title: Kavenio API version: 1.0.0 license: name: Proprietary url: https://kavenio.com/terms description: Generated OpenAPI document for the stable Kavenio public API. servers: - url: https://api.kavenio.com security: - bearerAuth: [] tags: - name: API keys description: Manage Kavenio API keys for the authenticated user. - name: Integrations description: Connect automation clients and manage workflow subscriptions. - name: Feature requests description: Submit feature requests from authenticated users. - name: Posts description: Create, schedule, update, and manage post lifecycle actions. - name: Queue description: Manage reusable post queue schedules and preview slots. - name: Media description: Upload, presign, and validate media assets. - name: Validation description: Validate post payloads and platform content length limits. - name: Connect description: Start and complete account connection flows. - name: Accounts description: Manage connected social accounts and account health. - name: Telegram description: Manage Telegram-specific connected account settings. - name: Discord description: Manage Discord messages, roles, pins, events, and settings. - name: Google Business description: Manage Google Business locations, reviews, and helpers. - name: Ads description: Create, read, cancel, and inspect advertising resources. - name: Ad audiences description: Manage advertising audiences and audience members. - name: Ad catalogs description: Inspect advertising catalogs and product sets. - name: Ad targeting description: Search targeting entities and estimate audience reach. - name: Ad conversions description: Manage conversion destinations and send conversion events. - name: Ad leads description: Manage lead forms and retrieve advertising leads. - name: Tracking tags description: Manage Meta tracking tags and tag sharing. - name: Platform credentials description: Manage organization platform app credentials. - name: Analytics description: Read provider analytics and operational inbox data. - name: WhatsApp conversions description: Read and send WhatsApp conversion events. - name: Activity description: Read operational activity events. - name: Webhooks description: Manage webhook endpoints and delivery logs. paths: /v1/ads/conversions: post: tags: - Ad conversions summary: Send conversion events description: Sends conversion events to a configured provider conversion destination. operationId: sendConversions requestBody: required: true content: application/json: example: accountId: bbbbbbbbbbbbbbbb destinationId: eeeeeeeeeeeeeeee events: - eventName: Purchase eventTime: 1782380000 eventId: event_example value: 25 currency: USD user: email: person@example.com schema: type: object properties: accountId: type: string minLength: 16 maxLength: 16 pattern: ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$ destinationId: type: string minLength: 1 events: minItems: 1 maxItems: 5000 type: array items: type: object properties: eventName: type: string minLength: 1 eventTime: type: integer minimum: 0 maximum: 9007199254740991 eventId: type: string minLength: 1 value: type: number currency: type: string minLength: 3 maxLength: 3 user: type: object properties: email: type: string minLength: 1 phone: type: string minLength: 1 firstName: type: string minLength: 1 lastName: type: string minLength: 1 externalId: type: string minLength: 1 ipAddress: type: string minLength: 1 userAgent: type: string minLength: 1 country: type: string minLength: 1 city: type: string minLength: 1 state: type: string minLength: 1 zip: type: string minLength: 1 dob: type: string minLength: 1 gender: type: string minLength: 1 clickIds: type: object properties: fbc: type: string minLength: 1 fbp: type: string minLength: 1 gclid: type: string minLength: 1 gbraid: type: string minLength: 1 wbraid: type: string minLength: 1 li_fat_id: type: string minLength: 1 additionalProperties: false additionalProperties: false items: type: array items: type: object properties: id: type: string minLength: 1 name: type: string minLength: 1 price: type: number minimum: 0 quantity: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 category: type: string minLength: 1 additionalProperties: false sourceUrl: type: string format: uri actionSource: type: string enum: - web - app - offline - crm - phone_call - system_generated platformData: type: object propertyNames: type: string additionalProperties: {} required: - eventName - eventTime - eventId - user additionalProperties: false testCode: type: string minLength: 1 consent: type: object properties: adUserData: type: string enum: - GRANTED - DENIED adPersonalization: type: string enum: - GRANTED - DENIED additionalProperties: false required: - accountId - destinationId - events additionalProperties: false responses: '200': description: Send conversion events completed. content: application/json: schema: anyOf: - type: object properties: ok: type: boolean x-kavenio-const: true data: type: object properties: platform: type: string enum: - metaads - googleads - linkedinads eventsReceived: type: integer minimum: 0 maximum: 9007199254740991 eventsFailed: type: integer minimum: 0 maximum: 9007199254740991 failures: type: array items: type: object properties: eventIndex: type: integer minimum: 0 maximum: 9007199254740991 eventId: type: string minLength: 1 message: type: string minLength: 1 code: anyOf: - type: string - type: number required: - eventIndex - message additionalProperties: false traceId: type: string minLength: 1 required: - platform - eventsReceived - eventsFailed - failures additionalProperties: false required: - ok - data additionalProperties: false - type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false '401': description: Authentication failed. content: application/json: schema: type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false '422': description: Request validation failed. content: application/json: schema: type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false '500': description: Request failed. content: application/json: schema: type: object properties: ok: type: boolean x-kavenio-const: false error: type: object properties: code: type: string minLength: 1 message: type: string minLength: 1 details: {} required: - code - message additionalProperties: false required: - ok - error additionalProperties: false components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Clerk session or OAuth token ````