---
title: "Update Audience Suggestion"
method: PATCH
path: "/campaigns/audience-builds/{build_id}/suggestions/{suggestion_id}"
tags: ["campaigns"]
---

# Update Audience Suggestion

`PATCH /campaigns/audience-builds/{build_id}/suggestions/{suggestion_id}`

Include or exclude a suggested audience customer.

## Path parameters

- `build_id` string, required
- `suggestion_id` string, required

## Request body

- UpdateAudienceSuggestionRequest
  - `included` boolean, required

## Response `200`

Successful Response

- CampaignAudienceBuild
  - `id` string, required
  - `status` string, required
  - `progress` integer
  - `step` string
  - `activity` string[]
  - `description` string, required
  - `interpreted_plan` object
  - `error_message` string, nullable
  - `candidate_count` integer
  - `suggested_count` integer
  - `selected_count` integer
  - `audience_limit` integer, nullable
  - `suggestions` AudienceSuggestion[]
    - `id` string, required
    - `st_customer_id` string, required
    - `customer_name` string, required
    - `phones` string[]
    - `emails` string[]
    - `location_addresses` string[]
    - `customer_tags` object[]
    - `location_tags` object[]
    - `membership_type_names` string[]
    - `service_names` string[]
    - `explanation` string
    - `reasons` string[]
    - `confidence` number
    - `included` boolean
    - `rank` integer
    - `recent_campaign_contacts` RecentCampaignContact[]
      - `campaign_id` string, required
      - `campaign_name` string, required
      - `contacted_at` string, required
      - `status` string
    - `active_followup_overlap` boolean
    - `active_followup_count` integer
    - `active_followup_statuses` string[]
  - `created_at` string, required
  - `updated_at` string, nullable

## Other responses

- `404` — Not found
- `422` — Validation Error

## Changes

- **2026-09-02** `d96feef8e2ef` — 1 info
  - added the optional property `suggestions/items/location_tags` to the response with the `200` status

[Change history](https://skmtc.dev/noso/apis/crucible-backend-api/changes/campaigns/audience-builds/:build_id/suggestions/:suggestion_id/patch.md)

---

[API](https://skmtc.dev/noso/apis/crucible-backend-api.md) · [All operations](https://skmtc.dev/noso/apis/crucible-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/noso/apis/crucible-backend-api/revisions/6139ed1f70a9?raw)