Skip to main content
POST
/
sandbox
/
hubspot
/
{sandbox_id}
/
initialize
Initialize hubspot sandbox with data
curl --request POST \
  --url https://api.klavis.ai/sandbox/hubspot/{sandbox_id}/initialize \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "companies": [
    {
      "company_name": "TechCorp Solutions",
      "website_domain": "techcorp.com",
      "industry": "COMPUTER_SOFTWARE",
      "city": "San Francisco",
      "state_region": "CA",
      "country": "United States",
      "phone_number": "+1-415-555-0101",
      "employee_count": "250",
      "yearly_revenue": "15000000"
    },
    {
      "company_name": "DataFlow Analytics",
      "website_domain": "dataflow-analytics.com",
      "industry": "INFORMATION_TECHNOLOGY_AND_SERVICES",
      "city": "Austin",
      "state_region": "TX",
      "country": "United States",
      "phone_number": "+1-512-555-0201",
      "employee_count": "75",
      "yearly_revenue": "5000000"
    },
    {
      "company_name": "CloudScale Inc",
      "website_domain": "cloudscale.io",
      "industry": "INTERNET",
      "city": "Seattle",
      "state_region": "WA",
      "country": "United States",
      "phone_number": "+1-206-555-0301",
      "employee_count": "500",
      "yearly_revenue": "45000000"
    }
  ],
  "contacts": [
    {
      "first_name": "John",
      "last_name": "Smith",
      "email_address": "[email protected]",
      "phone_number": "+1-415-555-0102",
      "job_title": "CTO"
    },
    {
      "first_name": "Sarah",
      "last_name": "Johnson",
      "email_address": "[email protected]",
      "phone_number": "+1-415-555-0103",
      "job_title": "VP of Engineering"
    },
    {
      "first_name": "Michael",
      "last_name": "Chen",
      "email_address": "[email protected]",
      "phone_number": "+1-415-555-0104",
      "job_title": "Product Manager"
    },
    {
      "first_name": "Emily",
      "last_name": "Rodriguez",
      "email_address": "[email protected]",
      "phone_number": "+1-512-555-0202",
      "job_title": "CEO"
    },
    {
      "first_name": "David",
      "last_name": "Kim",
      "email_address": "[email protected]",
      "phone_number": "+1-512-555-0203",
      "job_title": "Data Architect"
    },
    {
      "first_name": "Jennifer",
      "last_name": "Williams",
      "email_address": "[email protected]",
      "phone_number": "+1-206-555-0302",
      "job_title": "Head of Operations"
    },
    {
      "first_name": "Alex",
      "last_name": "Thompson",
      "email_address": "[email protected]",
      "phone_number": "+1-555-0401",
      "job_title": "Independent Consultant"
    },
    {
      "first_name": "Maria",
      "last_name": "Garcia",
      "email_address": "[email protected]",
      "phone_number": "+1-555-0402",
      "job_title": "Founder"
    }
  ],
  "deals": [
    {
      "title": "Enterprise License Agreement",
      "value": "150000",
      "stage": "contractsent",
      "pipeline": "default",
      "expected_close_date": "2024-03-15T00:00:00Z"
    },
    {
      "title": "Professional Services Package",
      "value": "50000",
      "stage": "qualifiedtobuy",
      "pipeline": "default",
      "expected_close_date": "2024-04-01T00:00:00Z"
    },
    {
      "title": "Annual Platform Subscription",
      "value": "200000",
      "stage": "decisionmakerboughtin",
      "pipeline": "default",
      "expected_close_date": "2024-02-28T00:00:00Z"
    },
    {
      "title": "Starter Package",
      "value": "25000",
      "stage": "presentationscheduled",
      "pipeline": "default",
      "expected_close_date": "2024-03-30T00:00:00Z"
    },
    {
      "title": "Multi-year Enterprise Deal",
      "value": "500000",
      "stage": "appointmentscheduled",
      "pipeline": "default",
      "expected_close_date": "2024-05-15T00:00:00Z"
    },
    {
      "title": "Consulting Engagement",
      "value": "75000",
      "stage": "qualifiedtobuy",
      "pipeline": "default",
      "expected_close_date": "2024-03-20T00:00:00Z"
    },
    {
      "title": "Individual License",
      "value": "5000",
      "stage": "qualifiedtobuy",
      "pipeline": "default",
      "expected_close_date": "2024-02-28T00:00:00Z"
    },
    {
      "title": "Partnership Opportunity",
      "value": "100000",
      "stage": "qualifiedtobuy",
      "pipeline": "default",
      "expected_close_date": "2024-04-30T00:00:00Z"
    }
  ],
  "tickets": [
    {
      "title": "API integration question",
      "description": "Need clarification on webhook authentication",
      "pipeline": "0",
      "workflow_stage": "1",
      "priority_level": "MEDIUM"
    },
    {
      "title": "Feature request: SSO integration",
      "description": "Request for SAML-based single sign-on capability",
      "pipeline": "0",
      "workflow_stage": "1",
      "priority_level": "HIGH"
    },
    {
      "title": "Data export format question",
      "description": "Need to understand available export formats and scheduling options",
      "pipeline": "0",
      "workflow_stage": "1",
      "priority_level": "LOW"
    },
    {
      "title": "Billing question",
      "description": "Question about payment options and invoicing",
      "pipeline": "0",
      "workflow_stage": "1",
      "priority_level": "LOW"
    },
    {
      "title": "Startup program inquiry",
      "description": "Interested in joining startup accelerator program",
      "pipeline": "0",
      "workflow_stage": "1",
      "priority_level": "MEDIUM"
    },
    {
      "title": "General inquiry from website",
      "description": "Visitor submitted question through contact form",
      "pipeline": "0",
      "workflow_stage": "1",
      "priority_level": "LOW"
    }
  ],
  "tasks": [
    {
      "title": "Follow up on contract review",
      "description": "Check if legal team has finished reviewing the contract",
      "task_status": "IN_PROGRESS",
      "priority_level": "HIGH",
      "deadline": "2024-02-20T17:00:00Z"
    },
    {
      "title": "Schedule implementation call",
      "description": "Set up kick-off meeting with implementation team",
      "task_status": "NOT_STARTED",
      "priority_level": "MEDIUM",
      "deadline": "2024-03-01T10:00:00Z"
    },
    {
      "title": "Prepare custom proposal",
      "description": "Create tailored services proposal based on discovery call",
      "task_status": "IN_PROGRESS",
      "priority_level": "HIGH",
      "deadline": "2024-02-18T17:00:00Z"
    },
    {
      "title": "Research webhook authentication options",
      "description": "Document different authentication methods available",
      "task_status": "COMPLETED",
      "priority_level": "MEDIUM",
      "deadline": "2024-02-15T12:00:00Z"
    },
    {
      "title": "Send quarterly business review invitation",
      "description": "Schedule QBR meeting for Q1 2024",
      "task_status": "NOT_STARTED",
      "priority_level": "MEDIUM",
      "deadline": "2024-03-01T09:00:00Z"
    },
    {
      "title": "Evaluate SSO requirements",
      "description": "Gather detailed requirements from customer",
      "task_status": "IN_PROGRESS",
      "priority_level": "HIGH",
      "deadline": "2024-02-22T17:00:00Z"
    },
    {
      "title": "Create SSO implementation estimate",
      "task_status": "NOT_STARTED",
      "priority_level": "MEDIUM",
      "deadline": "2024-02-25T17:00:00Z"
    },
    {
      "title": "Schedule product demo",
      "description": "Demo new features to TechCorp team",
      "task_status": "NOT_STARTED",
      "priority_level": "HIGH",
      "deadline": "2024-02-28T14:00:00Z"
    },
    {
      "title": "Prepare pricing options",
      "description": "Create tiered pricing proposal with volume discounts",
      "task_status": "COMPLETED",
      "priority_level": "HIGH",
      "deadline": "2024-02-10T17:00:00Z"
    },
    {
      "title": "Coordinate with finance team",
      "description": "Ensure invoicing and payment terms are set up",
      "task_status": "IN_PROGRESS",
      "priority_level": "MEDIUM",
      "deadline": "2024-02-25T12:00:00Z"
    },
    {
      "title": "Prepare demo presentation",
      "description": "Customize demo to show analytics-specific features",
      "task_status": "IN_PROGRESS",
      "priority_level": "HIGH",
      "deadline": "2024-02-19T15:00:00Z"
    },
    {
      "title": "Send case study documents",
      "description": "Share relevant customer success stories",
      "task_status": "NOT_STARTED",
      "priority_level": "MEDIUM",
      "deadline": "2024-02-20T10:00:00Z"
    },
    {
      "title": "Schedule C-level meeting",
      "description": "Arrange meeting with CEO and CFO",
      "task_status": "IN_PROGRESS",
      "priority_level": "HIGH",
      "deadline": "2024-02-21T16:00:00Z"
    },
    {
      "title": "Prepare ROI analysis",
      "description": "Build comprehensive ROI model for 3-year contract",
      "task_status": "NOT_STARTED",
      "priority_level": "HIGH",
      "deadline": "2024-02-27T17:00:00Z"
    },
    {
      "title": "Draft statement of work",
      "description": "Create detailed SOW for consulting services",
      "task_status": "IN_PROGRESS",
      "priority_level": "HIGH",
      "deadline": "2024-02-23T17:00:00Z"
    },
    {
      "title": "Send license agreement",
      "task_status": "NOT_STARTED",
      "priority_level": "MEDIUM",
      "deadline": "2024-02-17T12:00:00Z"
    },
    {
      "title": "Review startup program eligibility",
      "description": "Check if company meets program criteria",
      "task_status": "IN_PROGRESS",
      "priority_level": "MEDIUM",
      "deadline": "2024-02-19T17:00:00Z"
    },
    {
      "title": "Send startup program information",
      "description": "Share details about benefits and application process",
      "task_status": "NOT_STARTED",
      "priority_level": "HIGH",
      "deadline": "2024-02-20T11:00:00Z"
    },
    {
      "title": "Research potential partner",
      "description": "Gather information about partnership fit and objectives",
      "task_status": "IN_PROGRESS",
      "priority_level": "MEDIUM",
      "deadline": "2024-02-25T17:00:00Z"
    },
    {
      "title": "Respond to inquiry",
      "description": "Provide initial response and gather more details",
      "task_status": "NOT_STARTED",
      "priority_level": "LOW",
      "deadline": "2024-02-18T17:00:00Z"
    },
    {
      "title": "Weekly team standup",
      "description": "Regular sync meeting with sales team",
      "task_status": "NOT_STARTED",
      "priority_level": "MEDIUM",
      "deadline": "2024-02-19T10:00:00Z"
    },
    {
      "title": "Update CRM data quality",
      "description": "Review and clean up duplicate records",
      "task_status": "IN_PROGRESS",
      "priority_level": "LOW",
      "deadline": "2024-02-29T17:00:00Z"
    }
  ]
}
'
{
  "sandbox_id": "<string>",
  "status": "idle",
  "message": "<string>",
  "records_created": {}
}

Authorizations

Authorization
string
header
required

Your Klavis AI API key.

Path Parameters

sandbox_id
string
required

The unique sandbox identifier

Query Parameters

init_default_data
boolean
default:false

If true, use default test data for initialization

Body

application/json

Complete HubSpot sandbox data structure (Flat Schema).

All object types are top-level lists. Relationships are defined via association fields in the respective objects (e.g. associated_company_names in HubSpotContact).

companies
HubSpotCompany · object[] | null

List of companies

contacts
HubSpotContact · object[] | null

List of contacts

deals
HubSpotDeal · object[] | null

List of deals

tickets
HubSpotTicket · object[] | null

List of tickets

tasks
HubSpotTask · object[] | null

List of tasks

Response

Successful Response

Response model for sandbox initialization

sandbox_id
string
required

Sandbox identifier

status
enum<string>
required

Current status

Available options:
idle,
occupied,
error
message
string
required

Initialization result message

records_created
Records Created · object

Count of records created per object type