Skip to Content

Connect GrowSurf to Your AI Agent

Connect GrowSurf to look up participants and carry out referral operations with an AI assistant.

10 toolsAPI key

20,000 free app calls every month(paid services billed separately)

Try a GrowSurf Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillGrowSurf

Review participants

Find a program and inspect its participants.

/oo GrowSurf: List my programs, then show the first page of participants in [program].

Add a participant

Register a participant with explicit referral attribution.

/oo GrowSurf: Add [email] to [program] with [referrer] as the referrer.

Manage referral credit

Trigger credit or cancel a pending delayed trigger.

/oo GrowSurf: Trigger referral credit for [participant] after a 14-day refund window.

Start Working with GrowSurf

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect GrowSurf

    Create a GrowSurf API key in Settings and connect it to your account.

    Connect GrowSurf→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • An eligible GrowSurf plan and an API key with team:read plus the program and participant permissions you need.
  • Existing emails return the original participant when creating a record.
  • Participant updates can suspend or ban affiliates. Deletion can leave analytics erasure pending.

GrowSurf Tools

Query your team and programs, page through participants, add or update records, and trigger or cancel delayed referral credit.

Review participants

Find a program and inspect its participants.

Add a participant

Register a participant with explicit referral attribution.

Manage referral credit

Trigger credit or cancel a pending delayed trigger.

Maintain team and participant records

Read team verification state, update participants, or delete records.

10 tools

Get Team

Get the GrowSurf team bound to your API key and its email verification state.

growsurf.get_team

List Campaigns

List GrowSurf programs belonging to your API key's team. Deleted programs are excluded.

growsurf.list_campaigns

Get Campaign

Get one GrowSurf program's configuration and totals.

growsurf.get_campaign

List Participants

List a page of GrowSurf participants. Pass nextId into the next request until null; metadata filters match all supplied values exactly.

growsurf.list_participants

Get Participant

Get a GrowSurf participant by ID or email address.

growsurf.get_participant

Create Participant

Add a GrowSurf participant; an existing email returns its participant unchanged. In affiliate programs, omitted isAffiliate enrolls an approved affiliate unless a valid referredBy is supplied. Referred signups may earn Lead rewards.

growsurf.create_participant

Update Participant

Update a GrowSurf participant. Can suspend or ban affiliates and expire referral credit. Supplied vanityKeys replace existing aliases; omitted fields remain unchanged.

growsurf.update_participant

Delete Participant

Delete a GrowSurf participant. Pending analytics erasure runs automatically; do not repeat deletion to complete it.

growsurf.delete_participant

Trigger Referral

Trigger referral credit for a GrowSurf participant immediately or after a delay managed by GrowSurf. Inspect success and message for the actual outcome.

growsurf.trigger_referral

Cancel Delayed Referral

Cancel a pending delayed GrowSurf referral trigger. Returns success false when there is no pending trigger.

growsurf.cancel_delayed_referral

Frequently Asked Questions

Where do I create an API key?

Use https://app.growsurf.com/settings#api-keys. Include team:read for connection validation.

Does adding an existing email update it?

No. GrowSurf returns the existing participant unchanged. Use update_participant for changes.

Does the connector wait for delayed credit?

No. GrowSurf schedules the credit. Inspect success and message, and cancel the pending trigger if needed.