Skip to main content

Tremendous Integration

ValueMapper supports Tremendous for reward issuance workflows.

Authentication options​

Tremendous can be connected in two supported ways:

  1. App / OAuth flow (recommended) — primary integration path for production accounts.
  2. API key (fallback) — supported for environments or accounts not yet using the OAuth app flow.

Option A: Connect with App / OAuth (recommended)​

  1. Open ValueMapper and go to Connected Services.
  2. Select Tremendous.
  3. Choose Connect with Tremendous and complete the OAuth authorization flow.
  4. Confirm the connected service appears as enabled.

Option B: Connect with API key (fallback)​

  1. Open ValueMapper and go to Connected Services.
  2. Select Tremendous.
  3. Generate your Tremendous API key: Tremendous API key docs.
  4. Add Tremendous as a connected service using addConnectedService.
  5. If you use Tremendous sandbox credentials, set sandbox: true.
mutation AddTremendousService {
  addConnectedService(
    connectedService: {
      serviceType: TREMENDOUS
      token: "<TREMENDOUS_API_KEY>"
      sandbox: true
    }
  ) {
    success
    errors
  }
}

Verify setup​

query ConnectedServices {
  account {
    connectedServices(enabled: true) {
      name
      serviceType
      enabled
      roles
      sandbox
    }
  }
}

Notes​

  • Promotions created with connectedServiceType: TREMENDOUS require an enabled Tremendous connected service on your account.
  • If no Tremendous service exists, promotion creation returns an error.
  • OAuth and API key authentication are both supported; OAuth is the default recommendation.