Creator Boost

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. To handle changes explicitly, use the PUT endpoint in Change Boosted Creator.

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",
    "creatorName": "Jane Doe",
    "isActive": true,
    "sponsoredAt": "2024-01-15T10:30:00.000Z"
  }
}

creatorName is a display-only field. It falls back to the creatorKey value when the creator name cannot be resolved.

Change Boosted Creator

Moves an existing boost to a different creator. A boost can only be changed 30 days after it was registered or last changed.

Changing resets the 30-day cooldown and fires a sponsor.changed webhook. The change is recorded in the boost history with action CHANGED.

Request

cURL
Node SDK
Go SDK

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

const sponsor = await server.sponsors.update('user_12345', {
  newCreatorKey: 'XYZ99',
  callbackId: 'game-session-abc123', // optional
});

sponsor, err := server.Sponsors.Update(ctx, "user_12345", playcamp.UpdateSponsorParams{
    NewCreatorKey: "XYZ99",
    CallbackID:    "game-session-abc123", // optional
})

Response (200 OK)

{
  "data": {
    "userId": "user_12345",
    "campaignId": "campaign_001",
    "creatorKey": "XYZ99",
    "creatorName": "John Smith",
    "isActive": true,
    "sponsoredAt": "2024-02-20T09:00: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('user_12345');

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

Boost History

Returns a user’s boost registration, change, and removal history, most recent first. Request

cURL
Node SDK
Go SDK

curl "https://sandbox-sdk-api.playcamp.io/v1/server/sponsors/user/user_12345/history?page=1&limit=20" \
  -H "Authorization: Bearer ak_server_xxx:secret"

const history = await server.sponsors.getHistory('user_12345', {
  page: 1,
  limit: 20,
});

// Iterate over the full history
for await (const entry of server.sponsors.listAllHistory('user_12345')) {
  console.log(entry.action, entry.creatorKey);
}

history, err := server.Sponsors.GetHistory(ctx, "user_12345", &playcamp.GetSponsorHistoryOptions{
    Page:  playcamp.Int(1),
    Limit: playcamp.Int(20),
})

Response (200 OK)

{
  "data": [
    {
      "userId": "user_12345",
      "campaignId": "campaign_001",
      "creatorKey": "XYZ99",
      "creatorName": "John Smith",
      "action": "CHANGED",
      "previousCreatorKey": "ABC12",
      "previousCreatorName": "Jane Doe",
      "createdAt": "2024-02-20T09:00:00.000Z"
    },
    {
      "userId": "user_12345",
      "campaignId": "campaign_001",
      "creatorKey": "ABC12",
      "creatorName": "Jane Doe",
      "action": "CREATED",
      "previousCreatorKey": null,
      "previousCreatorName": null,
      "createdAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 2, "totalPages": 1 }
}

`action`	Description
`CREATED`	Boost registered for the first time
`CHANGED`	Boost moved to a different creator
`ENDED`	Boost released

previousCreatorKey and previousCreatorName are only set when action is CHANGED.

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`	Within the 30-day cooldown, or creator not participating in the campaign	Wait for cooldown, verify campaign participation
400	`NO_ACTIVE_CAMPAIGN`	No active campaign found (`campaignId` omitted)	Specify `campaignId` or check campaign status
404	`NOT_FOUND`	Creator not found	Verify creatorKey

Platform

For Developers

For Creators

POST /sponsors Behavior

Flow

Create Boost

Change Boosted Creator

Remove Boost

Boost History

Optional Parameters

Error Handling

​POST /sponsors Behavior

​Flow

​Create Boost

​Change Boosted Creator

​Remove Boost

​Boost History

​Optional Parameters

​Error Handling

POST /sponsors Behavior

Flow

Create Boost

Change Boosted Creator

Remove Boost

Boost History

Optional Parameters

Error Handling