Skip to main content

Creator Boost

Updated

Set the creator that a user boosts. After setting a boost, the user’s payments are automatically attributed to the creator.

​

POST /sponsors Behavior

POST /sponsors works as upsert:

Current State Requested creatorKey Behavior
No boost - Create new
Boosting same creator Same Return current state
Boosting different creator Different Change after 30-day cooldown
Boost ended - Reactivate
 

​Flow 

1. Search/Select creator  →  2. Create boost (POST /sponsors)  →  3. Future payments auto-attributed

Create Boost

Request
curl -X POST "https://sandbox-sdk-api.playcamp.io/v1/server/sponsors" \
  -H "Authorization: Bearer ak_server_xxx:secret" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_12345",
    "creatorKey": "ABC12",
    "callbackId": "game-session-abc123"
  }'

const sponsor = await server.sponsors.create({
  userId: 'user_12345',
  creatorKey: 'ABC12',
  callbackId: 'game-session-abc123', // optional
});
sponsor, err := server.Sponsors.Create(ctx, playcamp.CreateSponsorParams{
    UserID:     "user_12345",
    CreatorKey: "ABC12",
    CallbackID: "game-session-abc123", // optional
})

Response (201 Created)

{
  "data": {
    "userId": "user_12345",
    "campaignId": "campaign_001",
    "creatorKey": "ABC12",
    "isActive": true,
    "sponsoredAt": "2024-01-15T10:30:00.000Z"
  }
}

Remove Boost

If campaignId is not specified, boost from the active campaign will be removed.Request

curl -X DELETE "https://sandbox-sdk-api.playcamp.io/v1/server/sponsors/user/user_12345" \
  -H "Authorization: Bearer ak_server_xxx:secret"

curl -X DELETE "https://sandbox-sdk-api.playcamp.io/v1/server/sponsors/user/user_12345" \
  -H "Authorization: Bearer ak_server_xxx:secret"

err := server.Sponsors.Delete(ctx, "user_12345", nil)
 
 

Optional Parameters

Field Type Description
campaignId string Campaign ID (auto-assigned to active campaign if not specified)
callbackId string Webhook tracking ID (included in webhook events)
isTest boolean Test mode (does not create actual data)

​

Error Handling

HTTP Code Description Action
400 BAD_REQUEST No active campaign or 30-day cooldown Check campaign status, wait for cooldown
404 NOT_FOUND Creator not found Verify creatorKey
Powered by Zendesk