OpenAI Integration

Connect your OpenAI API key to power AI enrichment columns with GPT-4o, GPT-4, GPT-3.5 Turbo, and O1 reasoning models. OpenAI is one of three AI providers supported by Enrichabl, alongside Google Gemini and Perplexity AI.

Overview

OpenAI powers AI columns and Multi AI columns in your enrichment pipelines. Once connected, you can create columns that use AI prompts with your lead data to generate insights, classifications, personalized content, and more.

Enrichabl uses a Bring Your Own Key (BYOK) model — you pay OpenAI directly at their standard rates with no markup from Enrichabl.

Getting Your OpenAI API Key

1. Go to platform.openai.com and sign in (or create an account)
2. Navigate to API Keys in the left sidebar
3. Click Create new secret key
4. Give it a name (e.g., "Enrichabl") and click Create
5. Copy the key immediately — it won't be shown again

Adding Your Key to Enrichabl

1. In Enrichabl, navigate to the API Keys page from the sidebar
2. Click Add API Key
3. Select OpenAI from the list of services
4. Paste your API key and click Add Key

Your key will appear in the API Keys list with an active/inactive toggle. You can only have one key per service. Keys can be toggled on or off without deleting them.

Supported Models

When creating an AI column or Multi AI column, select OpenAI as the AI Service Provider, then choose from these models:

GPT-4o (Recommended)

• Best for: Complex analysis, company research, personalized content generation
• Strengths: Most capable model, excellent at following structured output instructions
• Tradeoff: Higher cost per lead than lighter models

GPT-4o Mini (Default)

• Best for: Most enrichment tasks — good balance of quality and cost
• Strengths: Fast, affordable, handles most prompts well
• Tradeoff: May struggle with very complex multi-step reasoning

GPT-4 Turbo

• Best for: Tasks requiring the older GPT-4 architecture with faster responses

GPT-4

• Best for: Stable, well-tested output quality

GPT-3.5 Turbo

• Best for: Simple tasks like classification, formatting, or extraction where cost matters most
• Tradeoff: Lower quality on nuanced or complex prompts

O1, O1 Mini, O1 Preview

• Best for: Advanced reasoning tasks that require multi-step logic
• Strengths: Superior at analytical tasks, comparisons, and complex classifications
• Tradeoff: Slower and more expensive than GPT models

Using OpenAI in Your Pipelines

Single AI Columns

AI columns run a prompt against each lead and return a single text result. To create one:

1. Open a pipeline and go to the Enrichment tab
2. Click Create AI Column
3. Give the column a name (e.g., "Company Summary")
4. Write a prompt template using {{field_name}} variables to reference lead data
5. Select your API credentials and choose a model
6. Set max tokens (controls output length, up to 4000)

Writing Prompt Templates

Use double curly braces to insert lead data into your prompts. Click the field buttons in the form to insert them automatically.

Write a personalized cold email opening line for {{first_name}} at {{company}}.

Their role is {{job_title}} and they are in the {{industry}} industry.

Keep it under 2 sentences and reference something specific about their company.

Multi AI Columns

Multi AI columns extract multiple fields from a single AI call, which is more efficient and cost-effective than creating separate AI columns. The AI returns structured JSON, and each field becomes its own column in your lead table.

Research {{company}} and extract the following:
- industry: The primary industry they operate in
- employee_estimate: Estimated number of employees
- product_description: One-sentence description of their main product

Return ONLY valid JSON with these exact fields.

Define your expected output field names (e.g., industry, employee_estimate, product_description) in the form. Each field becomes a separate column prefixed with the column group name.

Column Chaining

AI column results can be referenced in other AI columns using the same {{column_name}} syntax. This lets you build multi-step enrichment workflows:

1. Step 1: An AI column researches the company and outputs a summary
2. Step 2: A second AI column references {{Company Summary}} to generate a personalized message

Batch Enrichment

Once your AI columns are configured, use Batch Enrichment to process leads in bulk. Select which AI columns to run and how many leads to process. Enrichabl handles queuing, retries, and rate limits automatically.

Best Practices

• Start with GPT-4o Mini: It's the default for a reason — fast, cheap, and good enough for most tasks
• Test on small batches: Run enrichment on 10-20 leads first to refine your prompts before processing thousands
• Be specific in prompts: Tell the model exactly what format you want (e.g., "respond with only a number", "return valid JSON")
• Use Multi AI columns: When you need multiple fields, a single Multi AI call is cheaper than multiple single AI calls
• Set spending limits: Configure a monthly spending cap in your OpenAI dashboard
• Validate emails first: Enrich only validated leads to avoid wasting API credits on bad data

Troubleshooting

Error: "Invalid API Key"

Cause: The key is incorrect, revoked, or belongs to a different organization.

Fix: Go to your OpenAI dashboard, verify the key is active, and re-add it in Enrichabl if needed.

Error: "Rate Limit Exceeded"

Cause: You've exceeded your OpenAI account's requests-per-minute or tokens-per-minute limit.

Fix: Enrichabl retries automatically with backoff. For sustained high volume, upgrade your OpenAI account tier by increasing your spend history.

Error: "Insufficient Quota"

Cause: Your OpenAI account has no remaining credits or has hit its spending limit.

Fix: Add a payment method or increase your spending limit at platform.openai.com.

No API Keys Available in Column Form

Cause: You haven't added an OpenAI key, or the key is toggled inactive.

Fix: Go to the API Keys page, add your key, and make sure it's toggled on (green).

Next Steps

• Learn more about AI Enrichment
• Learn about Batch Processing
• OpenAI API Documentation