For merchants who wish to integrate Giveaway Gator with other systems (e.g., loyalty programs or third-party apps). This allows administrators to manually add entries to a promotion. This is useful for handling special cases, contest adjustments, or customer service situations.

Add Manual Entry

Creates a new manual entry for a specific promotion.

URL: /api/v2/promos/[id]/manual-entry
Method: POST
Auth Required: Yes

Request Body

The request should be sent as multipart/form-data with the following fields:

name     (string) - Required - The entrant's full name
email    (string) - Required - The entrant's email address
entries  (number) - Required - Number of entries to add (minimum: 1)
reason   (string) - Required - Reason for adding the manual entry

Success Response

Code: 200 OK

{
     "success": true,
     "message": "Manual entry created"
}

Error Responses

Missing Required Fields: Code: 400 Bad Request

{
     "success": false,
     "message": "Missing required fields"
}

Invalid Entries Value: Code: 400 Bad Request

{
    "success": false,
    "message": "Invalid \\"entries\\" value"
}

Database Error: Code: 500 Internal Server Error

{
    "success": false,
    "message": "Error inserting manual entry"
}

Example Usage

curl -X POST \\
[<https://giveawaygator.app/api/v2/promos/123/manual-entry>](<https://giveawaygator.app/api/v2/promos/123/manual-entry>) \\
-H 'Content-Type: multipart/form-data' \\
-F 'name=John Doe' \\
-F '[email protected]' \\
-F 'entries=10' \\
-F 'reason=Customer service adjustment'

Notes