Creating Offers

Overview

Service offers are the foundation of your presence on Offergrid. Each offer represents a specific service package you’re making available to reseller partners.

Creating an Offer

Via Dashboard

Navigate to Offers

Click Offers in the sidebar menu

Create New Offer

Click the Create New Offer button

Fill in Basic Information

Name: Customer-facing name (e.g., “High-Speed Internet 1000 Mbps”)
Internal Name: Your internal tracking name (optional)
Category: Select the service type
SKU: Your product SKU for inventory tracking

Add Pricing

Pricing Type: Fixed, Variable, Tiered, or Custom
Monthly Price: Base recurring price
Setup Fees: One-time fees (optional)
Additional Costs: Equipment, installation, etc.

Add Service Details

Include service-specific information based on category (speeds, channels, coverage, etc.)

Configure Marketing Content

Description: Detailed service description
Marketing Headline: Catchy tagline
Key Features: Bullet points of main benefits
Images: Service photos or graphics

Set Availability

Service Area: ZIP codes or regions where available
Status: Draft (hidden) or Active (visible to resellers)

Save or Publish

Save as Draft to review later, or Publish to make available immediately

Via API

Create an offer programmatically using the Provider API:

curl -X POST https://api.offergrid.io/provider/offers \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "High-Speed Internet 1000 Mbps",
    "category": "internet",
    "status": "active",
    "monthlyPrice": 59.99,
    "description": "Blazing fast fiber internet with unlimited data",
    "keyFeatures": [
      "1000 Mbps download",
      "1000 Mbps upload",
      "Unlimited data",
      "No contract required"
    ],
    "internet": {
      "speed": {
        "minBandwidthMbps": 1000,
        "maxBandwidthMbps": 1000,
        "connectionType": "fiber"
      }
    }
  }'

const response = await fetch('https://api.offergrid.io/provider/offers', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.OFFERGRID_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'High-Speed Internet 1000 Mbps',
    category: 'internet',
    status: 'active',
    monthlyPrice: 59.99,
    description: 'Blazing fast fiber internet with unlimited data',
    keyFeatures: [
      '1000 Mbps download',
      '1000 Mbps upload',
      'Unlimited data',
      'No contract required',
    ],
    internet: {
      speed: {
        minBandwidthMbps: 1000,
        maxBandwidthMbps: 1000,
        connectionType: 'fiber',
      },
    },
  }),
});

const offer = await response.json();

Required Fields

At minimum, you must provide:

name - Public-facing offer name

Recommended Fields

For better reseller engagement, include:

description - Detailed service description
category - Service type (internet, electricity, or other)
monthlyPrice - Pricing information
keyFeatures - Bullet points of main benefits
electricity / internet - Category-specific structured contract (see Service Categories)

Offer Status

Control offer visibility with the status field:

draft: Hidden from resellers, visible only to you
active: Visible to authorized resellers, available for ordering
inactive: Temporarily hidden but can be reactivated
archived: Permanently archived, not available

Start with draft status while you finalize details, then switch to active when ready.

Consumer shop distribution

Beyond reseller (B2B) access, you can publish an offer to the public /shop storefront. This is opt-in and independent of reseller access — nothing appears in the shop unless you set consumerEnabled: true.

consumerEnabled - Set to true to list the offer on the public shop.
consumerMode - How the offer converts:
- checkout - the shopper completes the order inside Offergrid.
- lead_gen - the shop’s call-to-action logs a click and redirects the shopper to your own signup page (leadGenUrl) with attribution parameters; Offergrid creates no order.
leadGenUrl - The partner signup URL template for lead_gen offers. Must be an https:// URL and may embed {{variable}} placeholders in query-parameter values, rendered from collected customer data at handoff.

Supported template variables: first_name, last_name, full_name, email, phone, street, unit, city, state, zip, esiid, start_date, action (move/switch), tdsp_duns, click_id, offer_external_id.

{
  "consumerEnabled": true,
  "consumerMode": "lead_gen",
  "leadGenUrl": "https://partner.example.com/signup?ref=offergrid&fname={{first_name}}&zip={{zip}}"
}

The leadGenUrl template is fully validated (https, allowlisted variables, and placeholders only in query-parameter values) when the offer is published. A lead_gen offer cannot be published without a valid leadGenUrl.

Best Practices

Use clear, descriptive names

Make it easy for resellers to understand what you’re offering at a glance. Include key details like speeds, sizes, or service levels in the name.

Provide detailed specifications

The more details you provide, the easier it is for resellers to match your services to customer needs. Include technical specs, coverage details, and any limitations.

Add compelling marketing content

Help resellers sell your services by providing marketing headlines, key benefits, and high-quality images.

Keep pricing transparent

Include all fees and costs upfront. Clearly indicate recurring vs. one-time charges.

Update availability regularly

Keep service area and availability information current to avoid order failures.

Test before activating

Create offers in draft status first, review all details, and test the order flow before making them active.

Next Steps

Service Categories

Learn about category-specific requirements

Pricing Strategies

Understand different pricing models

Offer Visibility

Control who can see your offers

API Reference

View complete API documentation

Getting Started

Managing Offers

Order Fulfillment

Partner Management

Integration

Overview

Creating an Offer

Via Dashboard

Via API

Required Fields

Recommended Fields

Offer Status

Consumer shop distribution

Best Practices

Next Steps

Service Categories

Pricing Strategies

Offer Visibility

API Reference

​Overview

​Creating an Offer

​Via Dashboard

​Via API

​Required Fields

​Recommended Fields

​Offer Status

​Consumer shop distribution

​Best Practices

​Next Steps

Service Categories

Pricing Strategies

Offer Visibility

API Reference

Overview

Creating an Offer

Via Dashboard

Via API

Required Fields

Recommended Fields

Offer Status

Consumer shop distribution

Best Practices

Next Steps