Works with Headless/Hydrogen

This doc guides you on how to integrate BOGOS with your headless/Hydrogen store.

Overview

BOGOS offers two integration approaches for headless stores, each designed for different use cases and technical requirements. This guide breaks down both methods so you can choose the one that fits your setup:

Option 1: API Integration (Maximum Flexibility)

Option 2: JS/SDK Integration (Faster Implementation)

Option 1: API Integration (Maximum Flexibility)

Documentation: https://bogos-api-integration.gitbook.io/bogos-api-integration/integration-steps/gift-offer

Best for: Developers who need complete control and are building for any platform (web, mobile app, or third-party integrations)

What offers is supported

Currently, the API integration primarily focuses on gift offers, with basic data support for bundles and upsells. This approach gives you direct access to BOGOS's core functionality through API endpoints.

Advantages

  • Complete customization - Build exactly what you need

  • Platform agnostic - Works with web apps, mobile apps, and third-party integrations

  • Full control - Implement the logic exactly how you want it

Technical Requirements

Your development team needs solid expertise in:

  • Shopify platform architecture

  • Storefront API implementation

  • BOGOS app features and offer mechanics

This isn't a plug-and-play solution. You're building the integration from the ground up, which means your developers need to understand both the Shopify ecosystem and how BOGOS promotions work under the hood.

Option 2: JS/SDK Integration (Faster Implementation)

Documentation: https://bogos-api-integration.gitbook.io/bogos-api-integration/bogos-js-sdk

Best for: Web applications where speed of implementation matters and you want working code examples

What offers is supported

The JS/SDK currently supports most offer types (bundle-page support coming soon). This gives you broader coverage of BOGOS features with less implementation work.

Advantages

  • Faster development - Pre-built SDK handles the heavy lifting

  • Concrete examples - Demo code gets you started quickly

  • Less detailed knowledge required - Still need Shopify & storefront API expertise, but don't need to know every detail of BOGOS internals

Limitations

  • Web apps only - Not compatible with native mobile applications

Getting Started

Step 1: Review your technical requirements

  • What platforms do you need to support?

  • What types of offers will you run during BFCM?

  • What's your development timeline?

Step 2: Assess your team's expertise

  • How familiar are they with Shopify's architecture?

  • Do they have bandwidth to build from scratch (API) or need faster implementation (SDK)?

Step 3: Choose your Integration Method

  • API approach: Start with the gift-offer integration guide

  • SDK approach: Review the JS/SDK documentation and demo code

Step 4: Check the Docs and ask BOGOS Support Team for your bogos api-key

Step 5: Build using the instructions from your chosen method.

Last updated

Was this helpful?