Skip to main content
POST
/
campaigns
Create Campaign
curl --request POST \
  --url https://api.kakiyo.com/v1/campaigns \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Q2 Sales Outreach",
  "productId": "prod_123456789",
  "promptId": "prompt_987654321",
  "agentId": "agent_abcdef123456",
  "qualificationAutomatic": 75,
  "qualificationVerification": 50,
  "variables": {
    "companyValue": "Our AI-powered sales enablement platform",
    "painPoint": "low response rates on cold outreach",
    "benefit": "3x more qualified meetings"
  }
}
'
{
  "id": "campaign_12345abcde",
  "name": "Q2 Sales Outreach",
  "status": "active"
}

​
Overview

Create a new LinkedIn outreach campaign with AI-powered automation. This endpoint sets up a complete campaign with specified products, prompts, and agents, ready to start prospecting.

​
Use Cases

  • New Product Launch: Create campaigns for new product introductions
  • Market Expansion: Set up campaigns for new geographic markets
  • Seasonal Campaigns: Launch time-sensitive promotional campaigns
  • A/B Testing: Create multiple campaigns to test different approaches

​
Key Features

  • AI-Powered Messaging: Automated message generation using specified prompts
  • Smart Qualification: Automatic prospect qualification based on responses
  • Agent Assignment: Dedicated LinkedIn agents for authentic outreach
  • Performance Tracking: Built-in analytics and conversion tracking

​
Testing Example

curl -X POST "https://api.kakiyo.com/v1/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q4 Enterprise Outreach",
    "productId": "prod_123456789",
    "promptId": "prompt_987654321",
    "agentId": "agent_abcdef123456",
    "qualificationAutomatic": 75,
    "qualificationVerification": 50,
    "variables": {
      "company_name": "Your Company",
      "value_proposition": "20% increase in sales efficiency"
    }
  }'

// JavaScript/Node.js
const createCampaign = async (campaignData) => {
  const response = await fetch('https://api.kakiyo.com/v1/campaigns', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(campaignData)
  });

  return await response.json();
};

// Usage example
const newCampaign = await createCampaign({
  name: 'Q4 Enterprise Outreach',
  productId: 'prod_123456789',
  promptId: 'prompt_987654321',
  agentId: 'agent_abcdef123456',
  qualificationAutomatic: 75,
  qualificationVerification: 50,
  variables: {
    company_name: 'Your Company',
    value_proposition: '20% increase in sales efficiency'
  }
});

console.log('Campaign Created:', newCampaign);

# Python
import requests

def create_campaign(campaign_data):
    """Create a new LinkedIn outreach campaign"""
    response = requests.post(
        'https://api.kakiyo.com/v1/campaigns',
        json=campaign_data,
        headers={
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/json'
        }
    )

    return response.json()

# Usage example
campaign_data = {
    'name': 'Q4 Enterprise Outreach',
    'productId': 'prod_123456789',
    'promptId': 'prompt_987654321',
    'agentId': 'agent_abcdef123456',
    'qualificationAutomatic': 75,
    'qualificationVerification': 50,
    'variables': {
        'company_name': 'Your Company',
        'value_proposition': '20% increase in sales efficiency'
    }
}

result = create_campaign(campaign_data)
print('Campaign Created:', result)

​
Best Practices

  1. Descriptive Names: Use clear, descriptive campaign names
  2. Qualification Thresholds: Start with conservative qualification settings
  3. Variable Planning: Define all necessary variables before campaign creation
  4. Agent Capacity: Ensure assigned agents have available capacity
  5. Testing: Create test campaigns before launching to large prospect lists

​
Next Steps

After creating a campaign:
  1. Add Prospects: Use /prospects or /prospects/batch endpoints
  2. Monitor Performance: Check campaign analytics regularly
  3. Optimize Settings: Adjust qualification thresholds based on results
  4. Scale Gradually: Start with smaller prospect lists and scale up

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Campaign to create

​
name
string
required
Required string length: 3 - 100
Example:

"Q2 Sales Outreach"

​
productId
string
required
Example:

"prod_123456789"

​
promptId
string
required
Example:

"prompt_987654321"

​
agentId
string
required
Example:

"agent_abcdef123456"

​
qualificationAutomatic
integer
default:70
Required range: 0 <= x <= 100
Example:

75

​
qualificationVerification
integer
default:50
Required range: 0 <= x <= 100
Example:

50

​
variables
object
Example:
{
  "companyValue": "Our AI-powered sales enablement platform",
  "painPoint": "low response rates on cold outreach",
  "benefit": "3x more qualified meetings"
}

Response

Campaign created successfully

​
id
string
Example:

"campaign_12345abcde"

​
name
string
Example:

"Q2 Sales Outreach"

​
status
string
Example:

"active"