Selections

Read a campaign's chosen assets (social proof, lead magnets, risk reversal, value propositions) and its target audience. Requires the campaigns:read scope.

Get campaign selections

GET /api/v1/campaigns/:id/selections · scope campaigns:read

Returns the campaign's asset selections with any draft-format entries fully resolved (hydrated from the workspace's asset library), plus the campaign's target audience.

Path parameters

Example request

curl -X GET "https://app.machfive.io/api/v1/campaigns/CAMPAIGN_ID/selections" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (200 OK)

{
  "campaign_id": "uuid",
  "target_audience": {
    "id": "uuid",
    "segment_name": "Mid-market SaaS",
    "industry_vertical": "Software",
    "company_size": "50-200",
    "decision_makers": ["VP Marketing", "Head of Growth"]
  },
  "selections": [
    {
      "asset_type": "value_proposition",
      "selected_items": [
        { "id": "uuid", "name": "Faster onboarding", "description": "..." }
      ],
      "additional_details": null,
      "submitted_at": "2025-01-15T12:00:00.000Z"
    }
  ]
}

Free-text-only selections are valid. An asset type can be submitted with an empty selected_items array and only additional_details populated — this is a finalized selection, not an incomplete one (submitted_at will be set). This is common for risk_reversal, where a campaign may carry a custom free-text guarantee instead of picking from generated options.

Error responses