GrowSurf

GrowSurf Campaigns API

Program retrieval, listing, creation, updates, cloning, and configuration (design, emails, options, installation, and campaign rewards).

GitHub OpenAPI

Operations 28

GET /campaigns List campaigns #
POST /campaigns Create a campaign #
GET /campaign/{id} Retrieve a campaign #
PATCH /campaign/{id} Update a campaign #
POST /campaign/{id}/clone Clone a campaign #
GET /campaign/{id}/reward-configs List campaign rewards #
POST /campaign/{id}/reward-configs Create a campaign reward #
PATCH /campaign/{id}/reward-configs/{campaignRewardId} Update a campaign reward #
DELETE /campaign/{id}/reward-configs/{campaignRewardId} Delete a campaign reward #
GET /campaign/{id}/resources List program resources #
POST /campaign/{id}/resources Create a program resource #
PATCH /campaign/{id}/resources/{resourceId} Update a program resource #
DELETE /campaign/{id}/resources/{resourceId} Delete a program resource #
POST /campaign/{id}/resource-upload-tickets Create a program resource upload ticket #
GET /campaign/{id}/emails Retrieve campaign emails #
PATCH /campaign/{id}/emails Update campaign emails #
GET /campaign/{id}/installation Retrieve campaign installation #
PATCH /campaign/{id}/installation Update campaign installation #
POST /campaign/{id}/referral-flow-screenshots Capture referral-flow preview screenshots #
GET /campaign/{id}/options Retrieve campaign options #
PATCH /campaign/{id}/options Update campaign options #
GET /campaign/{id}/design Retrieve campaign design #
PATCH /campaign/{id}/design Update campaign design #
GET /campaign/{id}/custom-domain Retrieve campaign custom domain #
PUT /campaign/{id}/custom-domain Set campaign custom domain #
DELETE /campaign/{id}/custom-domain Delete campaign custom domain #
POST /campaign/{id}/custom-domain/verify Verify campaign custom domain #
GET /campaign/{id}/integrations List integrations #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/growsurf-com/openapi/growsurf-com-campaigns-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/growsurf-com/json-schema/growsurf-com-campaign-design-schema.json
📊
JSONSchema
https://artifacts.apis.io/growsurf-com/json-schema/growsurf-com-participant-schema.json
📊
JSONSchema
https://artifacts.apis.io/growsurf-com/json-schema/growsurf-com-campaign-emails-schema.json
📊
JSONSchema
https://artifacts.apis.io/growsurf-com/json-schema/growsurf-com-campaign-options-schema.json
📊
JSONSchema
https://artifacts.apis.io/growsurf-com/json-schema/growsurf-com-reward-schema.json
📊
JSONSchema
https://artifacts.apis.io/growsurf-com/json-schema/growsurf-com-record-transaction-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/growsurf-com:growsurf-com-campaigns-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

growsurf-com-campaigns-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: GrowSurf REST Campaigns API
  version: 2.0.0
  description: 'Public GrowSurf REST API for managing programs, participants, referrals,

    rewards, affiliate commissions, payouts, and analytics.


    Every endpoint requires a GrowSurf REST API key in the `Authorization: Bearer `

    header. To get one, sign up at https://app.growsurf.com, then create an API key in the GrowSurf

    dashboard. You can create multiple API keys, with optional scopes and program access limits.


    Each operation lists its required API-key scope in `x-growsurf-required-scopes`.

    Team scopes cover team details and verification; program scopes cover program settings,

    reward configuration, and webhooks; participant scopes cover participant records and

    referrals; reward scopes cover sales, commissions, payouts, and issued rewards; and

    analytics scope covers aggregate reporting. `api_key:rotate` is available only to direct

    API-key REST/SDK clients and is unavailable through MCP. `reward:fulfill` is separate

    because fulfillment may deliver something of value.


    The team owner''s email address must be verified before the API can manage programs and their

    resources. Until it is, those endpoints return a `403` with error code

    `EMAIL_NOT_VERIFIED_ERROR`. Resend the owner verification email via

    `POST /team/owner/verification-email`, then retry.


    For agent-led onboarding, use the canonical Arazzo 1.1 workflow at

    `https://growsurf.com/arazzo.yaml`. Starting from an API key the account owner created, it

    configures and verifies a draft program. It never launches a program or performs a paid,

    reward, payout, key-rotation, or destructive action.


    REST responses include `RateLimit-Policy` and `RateLimit` fields so clients can throttle before

    they reach a quota. Before authentication, these fields describe only the caller''s public

    network budget. After authentication, they describe the credential and team budgets. A `429`

    response also includes `Retry-After`; that value takes precedence when it is present. GrowSurf''s

    legacy rate-limit fields remain available for backward compatibility.


    GrowSurf versions this API in the URL and gives at least 12 calendar months of public notice

    before a planned breaking removal. The notice period starts when the public OpenAPI schema marks

    the affected surface as deprecated and GrowSurf publishes migration guidance. Urgent security,

    privacy, legal, or service-integrity requirements can require a shorter window. See the public

    lifecycle policy for the full rules and machine-readable signals.


    Every REST response carries `Link: ; rel="deprecation"` (RFC 9745), which points at

    that lifecycle policy. A surface that is actually deprecated adds a `Deprecation` field, and one

    with a planned shutdown date adds a `Sunset` field (RFC 8594). No `Deprecation` field means the

    surface is not deprecated.'
  contact:
    name: GrowSurf Support
    url: https://growsurf.com/settings#contact_support
  license:
    name: Proprietary
    url: https://growsurf.com/terms
  x-deprecation-policy:
    url: https://docs.growsurf.com/developer-tools/rest-api/api-lifecycle
    versioning: URL path (/v2)
    minimumNoticeMonths: 12
    signals:
    - 'Link: <https://docs.growsurf.com/developer-tools/rest-api/api-lifecycle>; rel="deprecation" (RFC 9745) on every response'
    - Deprecation response field (RFC 9745) once a surface is deprecated
    - Sunset response field (RFC 8594) once a shutdown date is planned
    - 'deprecated: true in this OpenAPI document'
servers:
- url: https://api.growsurf.com/v2
  description: Production
security:
- apiKeyAuth: []
tags:


# --- truncated at 32 KB (215 KB total) ---
# Full source: https://artifacts.apis.io/growsurf-com/openapi/growsurf-com-campaigns-api-openapi.yml