# Manual Entries API

For integrating Giveaway Gator with other systems (loyalty programs, third-party apps).

## Endpoint

```
POST /api/v2/promos/[id]/manual-entry
Content-Type: multipart/form-data
Auth Required: Yes
```

## Request Fields
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Entrant's full name |
| `email` | string | Yes | Entrant's email address |
| `entries` | number | Yes | Number of entries (minimum: 1) |
| `reason` | string | Yes | Reason for the manual entry |

## Example

```bash
curl -X POST \
  https://giveawaygator.app/api/v2/promos/123/manual-entry \
  -H 'Content-Type: multipart/form-data' \
  -F 'name=John Doe' \
  -F 'email=john@example.com' \
  -F 'entries=10' \
  -F 'reason=Customer service adjustment'
```

## Response

**Success (200):**
```json
{ "success": true, "message": "Manual entry created" }
```

**Error (400):**
```json
{ "success": false, "message": "Missing required fields" }
```

## Notes
- Entry appears with "MANUAL" as the order number
- Audit log shows the reason and total entries
- Timestamps use UTC