Skip to documentation
SparkGlimDeveloper
AI integration hub
SparkGlimSparkGlim Developer
Search all documentation

Try a topic in your language or an exact API path.

    Documentation navigation

    API reference

    Add creator-team member

    Adds a member through the existing creator-team workflow and stores the reseller relationship; the member completes normal organizer onboarding.

    POSThttps://api.sparkglim.net/api/white-label/portal/reseller/members

    Access model

    Access model
    SparkGlim session and member permissions
    Required scope
    members:write
    Documented availability
    Implemented in source

    Availability is verified from source, not a live production guarantee.

    Use the creator-team member workflow. Reseller access never grants unrestricted database or administrator access.

    Headers

    NameTypeValidation
    AuthorizationRequired

    Existing SparkGlim bearer session; server account membership and assigned capabilities still authorize each operation.

    		stringValidation: Bearer existing authenticated session token.

    Request

    NameTypeValidation
    userIdOptional

    Optional existing user association; this operation does not create an unrestricted creator account.

    		string|nullValidation: UUID existing user only.
    creatorIdOptional

    Authorized creator-team owner for the reseller relationship; defaults to the reseller owner where configured.

    		string|nullValidation: UUID authorized owner; defaults reseller creator.
    memberTypeOptional

    Reseller relationship role; assigned capabilities and creator-team permissions remain separately enforced.

    		enumValidation: owner | operator | finance | support | sub_creator.
    statusOptional

    Requested supported lifecycle state; account and campaign approval rules still control publication and access.

    		enumValidation: invited | pending | active | suspended | revoked.
    displayNameOptional

    Public display label for the member or contributor; it does not change account ownership.

    		string|nullValidation: 2–160.
    emailOptional

    Contact email used by the configured campaign or account workflow; never a credential granting access by itself.

    		string|nullValidation: email.
    phoneOptional

    Member or applicant contact phone used by the existing account workflow.

    		string|nullValidation: 8–40.
    rolesOptional

    Reseller role assignments accepted by the member schema, separately limited by server permissions.

    		string[]Validation: supported reseller roles.
    permissionsOptional

    Requested supported capabilities, limited by the account policy and caller’s authorization.

    		string[]Validation: supported reseller capabilities.
    otpRequiredOptional

    Controls the supported verification requirement for the resource; it does not bypass server eligibility checks.

    		booleanValidation: default true.
    kycStatusOptional

    Account review state recorded for this reseller relationship; it does not independently authorize payments.

    		enumValidation: not_required | pending | verified | rejected.
    metadataOptional

    Additional JSON metadata accepted by the documented schema; it never overrides authorization, prices or account ownership.

    		objectValidation: JSON object.

    Request

    Examples describe the contract and are not executed. Use authorized test records; never paste a real secret into these pages.

    POST /api/white-label/portal/reseller/members
    http
    POST /api/white-label/portal/reseller/members HTTP/1.1
Host: api.sparkglim.net
Authorization: Bearer <EXISTING_SESSION_TOKEN>
Content-Type: application/json

{
  "displayName": "Example member",
  "email": "member@example.com",
  "memberType": "sub_creator",
  "roles": [
    "sub_creator"
  ],
  "permissions": []
}

    Response

    Success response · HTTP 201
    json
    {
  "success": true,
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "pending"
  }
}
    Error response · HTTP 400
    json
    {
  "success": false,
  "error": "<ERROR_MESSAGE>"
}

    Validation, permissions, unavailable records and temporary service failures use the handler’s HTTP status and error payload.

    Limits & retries

    Default Server limit: 100 requests per IP per 60 seconds. Resource-specific controls also apply.

    Source compatibility

    Authorized operations require account-specific testing.

    • server/src/api/router.ts
    • server/src/api/routes/white-label.ts
    • server/src/white-label/reseller-service.ts
    • server/src/white-label/schemas.ts

    Continue building