21-Apr-2026 — Using the Ramblers Salesforce Mock Server

A practical walkthrough for developers loading member data into the Ramblers Salesforce mock and calling the API against it. Companion to the architecture article, which covers the design and internals; this series just gets you signed in, loaded with data, and making calls.

The service is live at salesforce-mock.ngx-ramblers.org.uk.

Who this is for

Developers integrating with the day-one Ramblers Salesforce contract from any consumer side — currently NGX-Ramblers, MailMan, and the Ramblers Head Office Salesforce team are the three first-class consumers. Each operator gets their own login, their own tenants, their own API tokens, and their own ingested data; per-operator isolation is enforced in MongoDB on every query, so nothing leaks between teams.

The end-to-end flow

flowchart LR
    A["1. Get an<br/>operator account"] --> B["2. Sign in<br/>at /admin/login"]
    B --> C["3. Create a tenant<br/>(groupCode<br/>or areaCode)"]
    C --> D["4. Generate an<br/>API token"]
    D --> E["5. Load member data<br/>(upload or generate)"]
    E --> F["6. Call the API<br/>with your token"]

Six steps — the sub-pages below pick up the detail. Read them in order on a first pass; come back to individual pages when you need a refresher.

Getting an account and signing in

Operator provisioning, then the two sign-in tabs (username + password, or bootstrap token).

Tenants and API tokens

Tenant codes (group or area), token generation, the one-time-reveal security model, and revocation.

Loading member data

Upload a real Insight Hub xlsx, generate synthetic data with configurable consent / roles / region / email patterns, or download the current dataset back out.

Calling the API

List members with incremental sync (?since=) and lapsed-member opt-in (?includeExpired=), writeback consent changes, or try-it-out interactively in Swagger UI.

Lifecycle scenarios

Shape a ?since= delta on demand: soft-remove, add, and amend members so a consumer's next incremental pull returns exactly the added / updated / removed changes you want to test.

Release notes and versioning

The /admin/release-notes view, the public /admin/api/version endpoint, and how the build-time snapshot gets baked in.

Root operator tasks

Provisioning new operators via the dashboard panel or the admin API, plus deployment-time bootstrap variables.