Postman / Insomnia

Postman

1. Open Postman → APIs tab → Import.
2. Choose Link and paste https://api.memberpass.net/openapi.json.
3. Postman generates a collection with every /v1/* endpoint organised by tag.
4. Set a collection variable called TOKEN to your MemberPass mpt_… token.
5. In the collection's Authorization tab, pick Bearer Token and bind to {{TOKEN}}.
6. In the collection's Pre-request Script, add an idempotency key generator:

pm.request.headers.add({
  key: "Idempotency-Key",
  value: pm.variables.replaceIn("{{$guid}}"),
});

Now every write request in the collection auto-injects a fresh UUID as the idempotency key.

Insomnia

1. Open Insomnia → Create → Import from URL → paste https://api.memberpass.net/openapi.json.
2. Select "Convert to Design Document" so you can browse operations by tag.
3. Create a new environment variable TOKEN and set it to your token value.
4. Insomnia reads the OpenAPI security block — requests inherit the bearer auth automatically.
5. Add a plugin or Before-Request script that sets Idempotency-Key: {% uuid 'v4' %}.

Syncing updates

The OpenAPI spec is regenerated on every MemberPass deploy. Re-import periodically, or configure Postman's "Sync" feature to auto-pull changes from the URL.

Using the spec for codegen

Both apps can export the spec back out, but for code generation you're better off using the raw JSON URL as the input to:

• openapi-generator (open-source, multi-language)
• Speakeasy / Stainless / Fern (commercial, opinionated SDKs)

See the OpenAPI reference for the x-required-scopes extension — any of the codegen tools preserves it as a comment on each operation.