> ## Documentation Index
> Fetch the complete documentation index at: https://playcamp.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create/Update Boost (Sponsor)

> User boosts a creator. Works in upsert mode.

**How it works:**
- No boost → Create new
- Already boosting same creator → Return current status
- Boosting different creator → Can change after 30-day cooldown
- Boost ended → Reactivate

Payments made after boosting will be attributed to that creator.




## OpenAPI

````yaml /api_docs/openapi.yaml post /v1/server/sponsors
openapi: 3.0.3
info:
  title: PlayCamp SDK API
  description: >
    PlayCamp SDK API - Game analytics and creator campaign integration API


    ## Required Integration APIs (Server API)

    3 APIs that must be integrated for campaign operation:

    - `POST /v1/server/sponsors` - User boosts a creator

    - `POST /v1/server/coupons/validate` - Validate coupon code

    - `POST /v1/server/payments` - Register in-game payment


    ## Authentication

    - **Client API**: `Authorization: Bearer {CLIENT_KEY_ID}:{CLIENT_SECRET}`

    - **Server API**: `Authorization: Bearer {SERVER_KEY_ID}:{SERVER_SECRET}`


    ## Servers

    - **Live**: https://sdk-api.playcamp.io (Production data)

    - **Sandbox**: https://sandbox-sdk-api.playcamp.io (Test data)


    ## Key Types

    - **Client Key**: For game client (read-only - campaign, creator queries)

    - **Server Key**: For game server (read/write - coupon redemption, payment
    registration, etc.)


    ## Test Mode (isTest)

    Before campaign launch, use `isTest: true` parameter to test API
    integration.

    - Request parameter validation is performed identically to production

    - Returns mock data without recording to actual DB

    - Verify integration in Sandbox environment before campaign launch, then
    remove `isTest` parameter for actual campaign
  version: 1.1.0
  contact:
    name: PlayCamp Support
servers:
  - url: https://sdk-api.playcamp.io
    description: Live Server
  - url: https://sandbox-sdk-api.playcamp.io
    description: Sandbox Server
  - url: http://localhost:3001
    description: Local Live Server
  - url: http://localhost:3003
    description: Local Sandbox Server
security: []
tags:
  - name: Health
    description: Server health check
  - name: Client Campaign
    description: Campaign queries (Client API)
  - name: Client Creator
    description: Creator queries (Client API)
  - name: Client Coupon
    description: Coupon validation (Client API)
  - name: Client Sponsor
    description: Boost status queries — Sponsor API (Client API)
  - name: Server Campaign
    description: Campaign queries (Server API)
  - name: Server Creator
    description: Creator queries (Server API)
  - name: Server Coupon
    description: Coupon management (Server API)
  - name: Server Sponsor
    description: Boost management — Sponsor API (Server API)
  - name: Server Payment
    description: Payment management (Server API)
  - name: Server Playtime
    description: Playtime session management (Server API)
  - name: Server Webhook
    description: Webhook management (Server API)
  - name: Server Webview
    description: WebView management (Server API)
paths:
  /v1/server/sponsors:
    post:
      tags:
        - Server Sponsor
      summary: Create/Update Boost (Sponsor)
      description: |
        User boosts a creator. Works in upsert mode.

        **How it works:**
        - No boost → Create new
        - Already boosting same creator → Return current status
        - Boosting different creator → Can change after 30-day cooldown
        - Boost ended → Reactivate

        Payments made after boosting will be attributed to that creator.
      operationId: serverCreateSponsor
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - userId
                - creatorKey
              properties:
                userId:
                  type: string
                  description: User ID
                campaignId:
                  type: string
                  description: >-
                    Campaign ID (auto-assigned to active campaign if not
                    specified)
                creatorKey:
                  type: string
                  pattern: ^[A-Z0-9]{5}$
                  description: 5-character creator key
                callbackId:
                  type: string
                  description: >-
                    Webhook tracking ID (included in webhook events triggered by
                    this request)
                isTest:
                  type: boolean
                  default: false
                  description: Test mode (does not create actual data)
      responses:
        '201':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/Sponsor'
        '400':
          description: |
            Bad request
            - No active campaign
            - Creator is not participating in the campaign
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: 400
                error: Bad Request
                message: No active campaign found
                code: BAD_REQUEST
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Creator not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: 404
                error: Not Found
                message: 'Creator not found: TEST1'
                code: NOT_FOUND
        '409':
          description: Already boosting a creator in this campaign
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: 409
                error: Conflict
                message: Already sponsoring a creator in this campaign
                code: CONFLICT
      security:
        - ServerAuth: []
components:
  schemas:
    Sponsor:
      type: object
      properties:
        userId:
          type: string
        campaignId:
          type: string
        creatorKey:
          type: string
        isActive:
          type: boolean
        sponsoredAt:
          type: string
          format: date-time
    Error:
      type: object
      required:
        - status
        - error
        - message
        - code
      properties:
        status:
          type: integer
          description: HTTP status code
        error:
          type: string
          description: HTTP status name
        message:
          type: string
          description: Detailed error message
        code:
          type: string
          description: |
            Error codes:
            - `VALIDATION_ERROR`: Request parameter validation failed
            - `BAD_REQUEST`: Invalid request
            - `UNAUTHORIZED`: Authentication failed (API key error)
            - `FORBIDDEN`: Access denied
            - `NOT_FOUND`: Resource not found
            - `CONFLICT`: Duplicate resource (already exists)
            - `INTERNAL_ERROR`: Internal server error
        details:
          type: array
          description: Validation error details (for VALIDATION_ERROR)
          items:
            type: object
            properties:
              path:
                type: string
              message:
                type: string
      example:
        status: 404
        error: Not Found
        message: 'Payment not found: txn-12345'
        code: NOT_FOUND
  responses:
    Unauthorized:
      description: Authentication failed (API key error)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 401
            error: Unauthorized
            message: Invalid API key
            code: UNAUTHORIZED
  securitySchemes:
    ServerAuth:
      type: http
      scheme: bearer
      description: 'Server API Key (format: {keyId}:{secret})'

````