TOtoksta
Campaigns

Get campaign details

Get a campaign by ID. SaaS workspace entitlement required.

get/v1/campaigns/{id}

Request

Path parameters

idstring required

Campaign UUID.

Response

Campaign detail.

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": "Toksta API",
      "target_regions": [
        "us",
        "uk"
      ],
      "target_audience": "Engineering leaders",
      "target_job_titles": [
        "CTO",
        "VP Engineering"
      ],
      "target_platforms": [
        "linkedin"
      ],
      "target_companies": [],
      "content_keywords": [
        "developer tools",
        "API"
      ],
      "target_audience_criteria": [
        "CTO",
        "VP Engineering"
      ],
      "search_country": "us",
      "creator_regions": [
        "us"
      ],
      "created_at": "2026-05-01T10:00:00Z",
      "updated_at": "2026-05-10T10: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.