Gameball

aid: gameball
name: Gameball
description: Gameball is a customer loyalty and gamification platform that helps consumer brands turn one-time buyers into
  repeat customers through points, VIP tiers, referrals, cashback, coupons, reward campaigns and gamified experiences (spin
  the wheel, scratch & win, missions, stamps) plus email/SMS/push communication and automation campaigns. It exposes a RESTful
  API (base https://api.gameball.co/api/{version}) secured with APIKey and SecretKey headers — v4.1 "Secure Integration Mode"
  is the documented current release, though the only OpenAPI Gameball publishes is v4.0. Alongside it are server SDKs for
  Node.js, Python, PHP, Ruby and .NET, actively-maintained mobile client SDKs for iOS, Android, Flutter and React Native,
  an embeddable web widget, signed webhooks, asynchronous batch ingestion, a test/live dual-key sandbox, an official OAuth-gated
  remote MCP server at https://mcp.gameball.co exposing 54 dashboard tools, a published A2A agent card and a provider-authored
  Agent Skill. Gameball is trusted by 3,000+ brands across 70+ countries and is a 500 Global portfolio company.
url: https://raw.githubusercontent.com/api-evangelist/gameball/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- 500-global
x-tier: stub
x-tier-reason: portfolio-lead
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-08-13'
image: https://cdn.prod.website-files.com/6908b0d43805904c24a1139a/6909d1a17d9fb50ab471f71f_logo.svg
tags:
- Company
- Loyalty
- Rewards
- Gamification
- Customer Engagement
- Retention
- Referrals
- Marketing
- E-commerce
apis:
- name: Gameball REST API
  description: RESTful loyalty & gamification API for managing customers, events, orders, payments, points transactions, holds,
    coupons, reward campaigns, VIP tiers, redemption options, leaderboards and batch operations.
  humanURL: https://docs.gameball.co/api-reference/introduction
  baseURL: https://api.gameball.co/api/v4.0
  properties:
  - type: Documentation
    url: https://docs.gameball.co
  - type: APIReference
    url: https://docs.gameball.co/api-reference/introduction
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: RateLimits
    url: rate-limits/gameball-rate-limits.yml
  - type: Webhooks
    url: asyncapi/gameball-webhooks.yml
  - type: ErrorCatalog
    url: errors/gameball-error-codes.yml
  - type: OpenAPI
    url: openapi/gameball-openapi.json
  - type: Overlay
    url: overlays/gameball-openapi-overlay.yaml
  - type: ErrorCatalog
    url: errors/gameball-problem-types.yml
  - type: Sandbox
    url: sandbox/gameball-sandbox.yml
  - type: AgentSkill
    url: skills/_index.yml
- name: Gameball MCP Server
  description: Official remote Model Context Protocol server exposing 54 tools over the Gameball merchant/dashboard surface
    — customer lookup and points adjustment, tag management, earning configuration and custom earning rules, redemption options,
    reward-campaign authoring (event, date, calendar, game, mission), tier and program state, widget settings and localization,
    and analytics. OAuth 2.0 with PKCE and dynamic client registration; a single "mcp" scope covers the whole surface.
  humanURL: https://github.com/gameballers/gameball-mcp-codex
  baseURL: https://mcp.gameball.co/mcp
  properties:
  - type: MCPServer
    url: mcp/gameball-mcp.yml
  - type: MCPServer
    url: https://mcp.gameball.co/mcp
  - type: ToolCrosswalk
    url: mcp/gameball-tool-crosswalk.yml
  - type: OAuthScopes
    url: scopes/gameball-scopes.yml
  - type: Authentication
    url: authentication/gameball-authentication.yml
  - type: SourceCode
    url: https://github.com/gameballers/gameball-mcp-codex
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://gameball.co
- type: DeveloperPortal
  url: https://developer.gameball.co
- type: Documentation
  url: https://docs.gameball.co
- type: APIReference
  url: https://docs.gameball.co/api-reference/introduction
- type: GettingStarted
  url: https://docs.gameball.co/product-documentation/getting-started/launch-checklist
- type: Support
  url: https://docs.gameball.co/
- type: Blog
  url: https://www.gameball.co/blog
- type: GitHubOrganization
  url: https://github.com/gameballers
- type: Pricing
  url: https://www.gameball.co/pricing
- type: SignUp
  url: https://app.gameball.co/login
- type: TermsOfService
  url: https://www.gameball.co/terms-and-conditions
- type: PrivacyPolicy
  url: https://www.gameball.co/privacy-policy
- type: Authentication
  url: authentication/gameball-authentication.yml
- type: Packages
  url: packages/gameball-packages.yml
- type: SDKs
  url: packages/gameball-packages.yml
- type: MCPServer
  url: mcp/gameball-mcp.yml
- type: LLMsTxt
  url: llms/gameball-llms.txt
- type: ErrorCatalog
  url: errors/gameball-error-codes.yml
- type: Conventions
  url: conventions/gameball-conventions.yml
- type: Idempotency
  url: conventions/gameball-conventions.yml
- type: RateLimits
  url: rate-limits/gameball-rate-limits.yml
- type: Lifecycle
  url: lifecycle/gameball-lifecycle.yml
- type: ChangeLog
  url: changelog/gameball-changelog.yml
- type: Webhooks
  url: asyncapi/gameball-webhooks.yml
- type: Components
  url: components/gameball-components.yml
- type: Conformance
  url: conformance/gameball-conformance.yml
- type: DataModel
  url: data-model/gameball-data-model.yml
- type: DomainSecurity
  url: security/gameball-domain-security.yml
- type: OpenAPI
  url: openapi/gameball-openapi.json
- type: Overlay
  url: overlays/gameball-openapi-overlay.yaml
- type: AgentCard
  url: a2a/gameball-a2a.yml
- type: AgentSkill
  url: skills/_index.yml
- type: WellKnown
  url: well-known/gameball-well-known.yml
- type: MCPServer
  url: https://mcp.gameball.co/mcp
- type: ToolCrosswalk
  url: mcp/gameball-tool-crosswalk.yml
- type: OAuthScopes
  url: scopes/gameball-scopes.yml
- type: Plans
  url: plans/gameball-plans-pricing.yml
- type: Sandbox
  url: sandbox/gameball-sandbox.yml
- type: ErrorCatalog
  url: errors/gameball-problem-types.yml
- type: StatusPage
  url: https://gameball.statuspage.io
- type: LLMsTxt
  url: https://docs.gameball.co/llms.txt
- type: ChangeLog
  url: https://docs.gameball.co/changelog/updates
- type: HelpCenter
  url: https://help.gameball.co
x-enrichment:
  date: '2026-08-13'
  status: enriched
  artifacts_added: 19
  pass: local-v1