# Start payout onboarding

Starts a payout onboarding.

```http
POST https://api.pozy.ai/public/creator-campaigns/{token}/payouts
```

- Area: Creators / Creator Portal
- Auth: none (public endpoint)

## Path parameters

- `token` (string, required)

## Request body

Content type: `application/json`

- `action`, string, required: One of `onboard`
- `country`, string: Matches `^[A-Za-z]{2}$`

## Example request

```bash
curl -X POST "https://api.pozy.ai/public/creator-campaigns/string/payouts" \
  -H "Content-Type: application/json" \
  -d '{
  "action": "onboard"
}'
```

```ts
const res = await fetch("https://api.pozy.ai/public/creator-campaigns/string/payouts", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    action: "onboard"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);
```

```python
import os
import requests

resp = requests.post(
    "https://api.pozy.ai/public/creator-campaigns/string/payouts",
    json={
        "action": "onboard",
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())
```

## Response 200

- `url`, string (URL), required

```json
{
  "url": "https://pozy.ai/media/example-1.jpg"
}
```