Creator Boost - Playcamp Docs

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

POST /sponsors handles both boost creation and changes in one API.

Flow

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

Create Boost

If campaignId is not specified, it will be automatically assigned to the currently active campaign.

When operating multiple campaigns for a single game, you must specify campaignId to distinguish between campaigns.

Request

cURL
Node SDK
Go SDK

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
Node SDK
Go SDK

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

await server.sponsors.remove({ userId: 'user_12345' });

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

Documentation Index

​POST /sponsors Behavior

​Flow

​Create Boost

​Remove Boost

​Optional Parameters

​Error Handling

POST /sponsors Behavior

Flow

Create Boost

Remove Boost

Optional Parameters

Error Handling