> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conduit.financial/llms.txt
> Use this file to discover all available pages before exploring further.

# Withdrawal Transaction

> Create your first crypto withdrawal transaction on Conduit using the Transactions API.

## Pre-requisites

* You have an active Conduit account with API access
* You have API credentials (API Key and Secret)
* You have reviewed our [Customers](/core-concepts/customers) Core Concepts

In this guide, you’ll create your first “withdrawal” transaction — sending cryptocurrency from a Conduit account to an external wallet.

<Steps>
  <Step title="Create a withdrawal transaction">
    To create a withdrawal transaction, use the `/transactions` endpoint.

    ### Request Example

    ```bash theme={null}
    curl --request POST \
      --url https://api.conduit.financial/transactions \
      --header "X-API-Key: your_api_key" \
      --header "X-API-Secret: your_api_secret" \
      --header "Content-Type: application/json" \
      --header "Api-Version: 2024-12-01" \
      --data '{
        "type": "withdrawal",
        "destination": {
          "walletId": "wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
          "asset": "USDC",
          "network": "ethereum",
          "amount": "1400.00"
        },
        "purpose": "Other",
        "reference": "PAYOUT-2024-001"
      }'
    ```

    ### Response Example

    ```json theme={null}
    {
      "type": "withdrawal",
      "id": "trxn_2ji0un2T6BaGhHKsmJu93Zf5OQm",
      "source": {
        "id": "acct_2kezVryAA3Uw9LJYBiXUV7Pj6gu",
        "asset": "USDC",
        "network": "ethereum",
        "amount": "1400.00"
      },
      "destination": {
        "id": "wlt_2nqjHpNLK6wSNlFyMvZgX8SYeAO",
        "asset": "USDC",
        "network": "ethereum",
        "amount": "1400.00"
      },
      "status": "created",
      "createdAt": "2024-10-26T02:21:03.742Z"
    }
    ```

    <Note>
      The destination can be a saved `walletId` or a raw blockchain `address`. Using `walletId` is recommended for address reuse and safety.
    </Note>
  </Step>

  <Step title="Monitor status via webhooks">
    Subscribe to webhook events to track the withdrawal lifecycle:

    | Event                               | Description                                 |
    | ----------------------------------- | ------------------------------------------- |
    | `transaction.processing_withdrawal` | Conduit is submitting the on-chain transfer |
    | `transaction.withdrawal_processed`  | On-chain submission completed               |
    | `transaction.processing_settlement` | Awaiting confirmations/finalization         |
    | `transaction.settlement_processed`  | Completed and settled                       |
  </Step>

  <Step title="Validate addresses and networks">
    Always ensure the destination address supports the specified asset and network. Sending to the wrong network can permanently lose funds.
  </Step>
</Steps>

## Summary

You have successfully created your first withdrawal transaction.

## What's next?

* Set up webhooks to receive transaction status updates: [Configuring Your First Webhook](/guides/webhooks/first-webhook)
* Review [Withdrawals](/core-concepts/transactions/withdrawal) Core Concept

## API Reference

See the [API Reference](/api-reference/transactions/create-a-transaction) for full schema and request details.

## Support

Reach out to our [support team](https://support.conduitpay.com/) to get help and share your feedback.