Record a win
const url = 'https://api.caller9.app/v1/contacts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/wins';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"studio_guid":"example","prize":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.caller9.app/v1/contacts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/wins \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "studio_guid": "example", "prize": "example" }'Records a contest win for the contact, timestamped now. Wins count toward the organization’s winner-history eligibility window in Contest Mode.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Contact ID (UUID).
Request Bodyrequired
Section titled “Request Bodyrequired”object
Studio the win happened on; must belong to the contact’s organization.
Example generated
{ "studio_guid": "example", "prize": "example"}Responses
Section titled “Responses”The recorded win.
object
object
Example generated
{ "win": { "guid": "example", "studio_guid": "example", "won_at": "2026-04-15T12:00:00Z", "prize": "example" }}The request was invalid.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Missing, invalid, expired or revoked API key.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Not found, or belongs to another organization.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Too many requests for this API key. Retry after Retry-After seconds.
object
Human-readable error message.
Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).
Example generated
{ "error": "example", "code": "example"}Headers
Section titled “Headers”Seconds until the rate-limit window resets.