---
title: "Create outbound search task with keywords and requirements"
method: POST
path: "/api/v1/search/outbound/create-task"
tags: ["Outbound Search"]
---

# Create outbound search task with keywords and requirements

`POST /api/v1/search/outbound/create-task`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/v1/search/outbound/create-task`
- Auth: HTTP bearer

Creates a new outbound search task by storing keywords and hard requirements in the unified outbound_keywords table.
- Supports both campaign-linked and standalone keyword tasks
- Processes keywords for TikTok, Instagram, and YouTube platforms
- Validates hard requirements including view counts, follower counts, and geographic filters
- Stores keywords with priority and notes for search execution
- Returns created keyword entries with their IDs for tracking

## Request body

- object
  - `campaign_id` string, uuid: Campaign ID to link keywords to (optional for standalone tasks)
  - `keywords` object, required: Platform-specific keywords for search
    - `tiktok` string[]: TikTok search keywords
    - `instagram` string[]: Instagram search keywords
    - `youtube` string[]: YouTube search keywords
  - `hard_requirements` object, required: Filtering criteria for creator search
    - `median_views_low` integer, required: Minimum median view count
    - `median_views_high` integer, required: Maximum median view count
    - `followers_low` integer, required: Minimum follower count
    - `followers_high` integer, required: Maximum follower count
    - `countries` string[], required: Target countries for creator location
  - `max_videos_per_keyword` integer: Maximum number of videos to process per keyword
  - `priority` integer: Task priority level (0 = lowest, 10 = highest)
  - `notes` string: Additional notes or context for the search task

## Response `200`

Search task created successfully

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `created_keywords` object[]
      - `id` string, uuid: Keyword entry ID
      - `platform` 'tiktok' | 'instagram' | 'youtube': Platform for this keyword
      - `keyword` string: The search keyword
      - `campaign_id` string, uuid, nullable: Associated campaign ID
      - `priority` integer: Task priority
      - `status` 'pending' | 'processing' | 'completed' | 'failed': Current processing status
    - `stats` object
      - `total_keywords` integer: Total number of keywords created
      - `platforms` object: Count per platform
        - `tiktok` integer
        - `instagram` integer
        - `youtube` integer

## Other responses

- `400`: Bad request - validation errors
- `404`: Campaign not found (when campaign_id provided)
- `500`: Internal server error

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)