ChatGPT (Custom GPT)

Build a Custom GPT that can access your Shopify store data through Ned's REST API.

INFO

ChatGPT doesn't support MCP. This guide uses Ned's REST API with ChatGPT's "Actions" feature instead.

What You'll Need

• A ChatGPT Plus or Team subscription (Actions require a paid plan)
• A Ned AI API key

Step 1: Get Your API Key

1. Go to app.meetned.com
2. Open Settings → Developer
3. Click Create API Key
4. Copy the key

Step 2: Create a Custom GPT

1. Go to chat.openai.com
2. Click your name → My GPTs → Create a GPT
3. In the Configure tab, set:
   • Name: My Store Assistant (or whatever you like)
   • Instructions:

     You are a Shopify store analytics assistant. Use the Ned API actions
     to answer questions about sales, profitability, customers, and marketing.
     Always present numbers clearly with currency formatting and percentages.

Step 3: Add an Action

1. Scroll down to Actions → Create new action
2. Set Authentication:
   • Type: API Key
   • Auth Type: Bearer
   • API Key: paste your ned_live_... key
3. In the Schema box, paste this OpenAPI spec:

openapi: 3.1.0
info:
  title: Ned AI API
  version: 1.0.0
  description: Shopify store analytics
servers:
  - url: https://api.meetned.com/api/v1
paths:
  /sales/analytics:
    get:
      operationId: getSalesAnalytics
      summary: Get sales metrics for a time period
      parameters:
        - name: period
          in: query
          schema:
            type: string
            default: today
            enum: [today, yesterday, this_week, last_week, this_month, last_month, last_7_days, last_30_days, mtd, ytd]
          description: Time period for analysis
        - name: comparison
          in: query
          schema:
            type: string
            default: year_ago
            enum: [year_ago, prior_period]
      responses:
        '200':
          description: Sales analytics data
  /profitability:
    get:
      operationId: getProfitability
      summary: Get profitability metrics
      parameters:
        - name: period
          in: query
          schema:
            type: string
            default: this_month
        - name: view_type
          in: query
          schema:
            type: string
            default: summary
            enum: [summary, daily]
      responses:
        '200':
          description: Profitability data
  /customers/segments:
    get:
      operationId: getCustomerSegments
      summary: Get customer segment breakdown
      parameters:
        - name: segment
          in: query
          schema:
            type: string
            default: both
            enum: [profit_tier, activity_tier, both]
        - name: limit
          in: query
          schema:
            type: integer
            default: 10
      responses:
        '200':
          description: Customer segments
  /marketing:
    get:
      operationId: getMarketingMetrics
      summary: Get marketing efficiency metrics
      parameters:
        - name: period
          in: query
          schema:
            type: string
            default: this_month
        - name: view_type
          in: query
          schema:
            type: string
            default: summary
            enum: [summary, daily, weekly, monthly]
      responses:
        '200':
          description: Marketing metrics

4. Click Test next to any endpoint to verify it connects.

Step 4: Save and Test

1. Click Save (choose "Only me" or "Anyone with a link")
2. Open your new GPT and try asking:
   • "How are my sales today?"
   • "What's my most profitable product this month?"
   • "Show me my marketing efficiency"

Troubleshooting

"Authentication failed" on test

• Make sure you selected Bearer as the auth type
• Verify the API key is correct and hasn't been revoked
• Check there are no extra spaces around the key

GPT doesn't call the actions

• Make sure the Instructions tell the GPT to use the Ned API
• Try being explicit: "Use the Ned API to check my sales today"

Actions not available

• Actions require ChatGPT Plus or Team — they aren't available on the free plan

Need Help?

• GitHub Issues
• Ned Support