---
title: "conversion.created"
method: POST
path: "conversion.created"
tags: ["Webhook Events"]
---

# conversion.created

`POST conversion.created` (webhook)

Sent when a conversion is created and processing has started.

## Payload

- object
  - `id` string, required: Unique identifier for the event. Stable across retries.
  - `type` 'conversion.created', required: Event type in resource.action format.
  - `api_version` string, required: API version the payload was rendered at. Stable across retries and redeliveries.
  - `payload` ConversionResourceDto, required
    - `id` string, uuid, required: Unique identifier of the conversion.
    - `type` 'conversion', required: Resource type discriminator.
    - `status` 'pending' | 'completed' | 'failed', required: Current status of the conversion.
    - `source_amount` string, required: Amount as a string decimal (e.g. "100.50").
    - `target_amount` string, required: Amount as a string decimal (e.g. "100.50").
    - `source_account_id` string, uuid, nullable, required: ID of the source account, or null.
    - `target_account_id` string, uuid, nullable, required: ID of the target account, or null.
    - `metadata` object, required: Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.
    - `created_at` string, date-time, required: ISO 8601 UTC timestamp when the conversion was created.
    - `updated_at` string, date-time, required: ISO 8601 UTC timestamp when the conversion was last updated.
    - `completed_at` string, date-time, nullable, required: ISO 8601 UTC timestamp when the conversion completed, or null.
  - `date` string, date-time, required: ISO 8601 UTC timestamp when the event was created.

## Acknowledgement `200`

Event received successfully.

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) - [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/augustus/apis/ivy-api/revisions/e87bdcac11cc?raw)