TOtoksta
Campaigns

Create a campaign

Create a campaign. SaaS workspace entitlement required — dedicated API keys receive 403.

name, content_keywords (≥1), and target_audience_criteria (≥1) are required.

post/v1/campaigns

Request

Request body

namestring required

Campaign name (required).

content_keywordsstring[] required

Content keywords (at least one required).

target_audience_criteriastring[] required

Audience criteria (at least one required).

product_idstring

Optional product UUID.

product_namestring
target_regionsstring[]
target_audiencestring
target_job_titlesstring[]
target_platformsstring[]
target_companiesstring[]
creator_regionsstring[]
search_countrystring

ISO country code. Defaults to us.

linkedin_content_typesstring[]
min_linkedin_followersnumber
max_linkedin_followersnumber
min_youtube_subscribersnumber
max_youtube_subscribersnumber
min_youtube_monthly_viewsnumber
max_youtube_monthly_viewsnumber

Example request

{
  "name": "Q3 Developer Launch",
  "content_keywords": [
    "developer tools",
    "API"
  ],
  "target_audience_criteria": [
    "CTO",
    "VP Engineering"
  ],
  "target_platforms": [
    "linkedin"
  ],
  "search_country": "us"
}

Response

Campaign created.

successtrue required
dataobject required

Operation payload. See the example for the exact field structure.

Example response

{
  "success": true,
  "data": {
    "campaign": {
      "id": "c1a2b3d4-e5f6-4789-9abc-0123456789ab",
      "name": "Q3 Developer Launch",
      "product_id": null,
      "product_name": null,
      "target_regions": [],
      "target_audience": null,
      "target_job_titles": [],
      "target_platforms": [
        "linkedin"
      ],
      "target_companies": [],
      "content_keywords": [
        "developer tools",
        "API"
      ],
      "target_audience_criteria": [
        "CTO",
        "VP Engineering"
      ],
      "search_country": "us",
      "creator_regions": [],
      "created_at": "2026-05-29T10:00:00Z",
      "updated_at": "2026-05-29T10:00:00Z"
    }
  },
  "meta": {
    "request_id": "req_01HXYZ...",
    "trace_id": "4f1d...c2"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.