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

# Create a Pix Out Transfer

> Create a transfer request, persist the Pagou transfer ID, and transition state from webhook delivery.

Use this page for the write path that starts a payout.

## Example request

```bash theme={null}
curl --request POST \
  --url https://api.pagou.ai/v2/transfers \
  --header "Authorization: Bearer YOUR_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "pix_key_type": "EMAIL",
    "pix_key_value": "supplier@example.com",
    "amount": 1200,
    "description": "Supplier payout",
    "external_ref": "payout_1001",
    "notify_url": "https://shop.example/webhooks/pagou/transfers"
  }'
```

## Example response

```json theme={null}
{
  "success": true,
  "requestId": "0190a2b4-18a7-7de0-9a43-69b7cf261201",
  "data": {
    "id": "018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72",
    "status": "pending",
    "amount": "1200",
    "pix_key_type": "EMAIL",
    "external_ref": "payout_1001",
    "created_at": "2026-03-16T14:00:00.000Z"
  }
}
```

## Common error

Status `422`

```json theme={null}
{
  "type": "https://api.pagou.ai/problems/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The request contains invalid data.",
  "errors": [
    {
      "field": "pix_key_value",
      "message": "Invalid PIX key value",
      "code": "invalid_string"
    }
  ]
}
```

Fix: send the correct `pix_key_type` and a matching `pix_key_value`. Do not document or depend on unsupported fields such as `recipient_name`.

## What to persist

* your payout request ID or `external_ref`
* Pagou transfer `id`
* current transfer `status`
* Pagou `requestId`

## Production note

Treat the create response as an acknowledgement, not final settlement. Final operational state belongs to webhook delivery and reconciliation.

## Next steps

* [Cancel a Pix Out Transfer](/payouts/pix-out/cancel-transfer)
* [Transfer Reconciliation](/payouts/pix-out/reconciliation)