ChatGPT GPT Actions Integration Guide

Overview

ChatGPT supports Custom GPTs with Actions, which let a GPT call external APIs on your behalf. By importing Orbyt's OpenAPI specification, you can build a GPT that reads your job pipeline, logs activities, and helps you prepare for interviews using your real data.

Prerequisites

• Orbyt Ultra plan
• ChatGPT Plus or Team plan (Custom GPTs require a paid ChatGPT plan)
• An Orbyt API key (generate one in Settings > Account > API Keys)

Step 1: Generate an API Key

1. Open Orbyt and go to Settings > Account
2. Scroll to API Keys
3. Click Create API Key
4. Name it "ChatGPT" and select Read & Write permissions
5. Copy the token (starts with ext_)

Step 2: Create a Custom GPT

1. Go to chat.openai.com and click Explore GPTs > Create
2. In the Configure tab, give your GPT a name like "Orbyt Job Tracker"
3. Add instructions such as:

You are a job search assistant connected to the user's Orbyt pipeline. Use the Orbyt API to help them track jobs, prepare for interviews, and manage their career search. Always check their current pipeline before giving advice.

Step 3: Add the Orbyt Action

1. Scroll down to Actions and click Create new action
2. For Authentication, select API Key and choose Bearer as the auth type
3. Paste your Orbyt API key (ext_...) as the API key value
4. In the Schema field, click Import from URL and enter:

https://www.orbytjobs.ai/openapi-gpt.yaml

1. ChatGPT will import all 23 Orbyt operations automatically
2. Click Save

Use this URL, not the full /openapi.yaml. The full spec documents every Orbyt API, mixes four auth schemes, and does not import cleanly as a GPT Action. The /openapi-gpt.yaml spec is trimmed to exactly the bearer-token pipeline operations a GPT can use, with an operationId on every operation as GPT Actions require.

Step 4: Test Your GPT

Try these prompts with your new GPT:

• "What's in my pipeline?" calls the pipeline endpoint for a summary
• "Show me jobs I should follow up on" checks suggestions for stale applications
• "Add a job: Product Manager at Figma, found on LinkedIn" creates a new job entry
• "Log that I had a phone screen with Stripe today" creates an activity
• "What interviews do I have coming up?" checks the calendar endpoint

Privacy Settings

When ChatGPT encounters an action for the first time, it will ask for your confirmation before calling the API. You can choose:

• Always allow: ChatGPT calls Orbyt automatically (best for personal GPTs)
• Ask each time: ChatGPT confirms before every API call (best for shared GPTs)

The OpenAPI spec marks mutation endpoints (POST, PATCH, DELETE) with x-openai-isConsequential: true, so ChatGPT will always confirm before making changes to your data.

Available Endpoints

All 23 Orbyt API operations are available through GPT Actions:

• Jobs: CRUD operations, status updates, pipeline analytics
• Contacts: List, create, update, delete with job linking
• Activities: Log calls, emails, interviews, and notes
• Calendar: View upcoming events and create new ones
• Pipeline: Get summary with follow-up suggestions
• Suggestions: AI agent recommendations
• Webhooks: Manage event subscriptions

Troubleshooting

"Action not available" error:

• Re-import the OpenAPI spec; ChatGPT may have cached an older version
• Make sure the schema URL is exactly https://www.orbytjobs.ai/openapi-gpt.yaml

Authentication errors (401/403):

• Verify the auth type is set to Bearer (not Basic)
• Re-paste your API key; ChatGPT may have truncated it
• Confirm your Orbyt plan is Ultra

GPT times out on large responses:

• Use query parameters to limit results (e.g., ?limit=10)
• Ask for specific data instead of "show me everything"

Tips

• Pin your GPT to the sidebar for quick access during your job search
• Combine Orbyt data with ChatGPT's knowledge: "Based on my pipeline and Stripe's recent earnings, help me prepare for my interview"
• Create separate GPTs for different workflows: one for interview prep, one for pipeline management

{
  "name": "Orbyt Job Tracker",
  "description": "Connected to your Orbyt job search pipeline. Can read your jobs, contacts, activities, calendar, and suggestions.",
  "instructions": "You are a job search assistant connected to the user's Orbyt pipeline via the Orbyt API. Use the available actions to help them track jobs, prepare for interviews, and manage their career search. Always check their current pipeline before giving advice. Be concise and actionable.",
  "actions": {
    "type": "openapi",
    "url": "https://www.orbytjobs.ai/openapi-gpt.yaml",
    "auth": { "type": "bearer" }
  }
}