---
title: "Update Match Booster configuration"
method: PATCH
path: "/models/{modelId}/match-booster"
---

# Update Match Booster configuration

`PATCH /models/{modelId}/match-booster`

## Request

- Base URL: `https://api.hightouch.com/api/v1`
- URL: `https://api.hightouch.com/api/v1/models/{modelId}/match-booster`
- Auth: HTTP bearer

Update a model's Match Booster configuration. Omitted fields are left
unchanged; `regions` and `columnMappings`, when provided, replace the
stored set. Audience models cannot be updated directly — target the
parent model (`settingsModelId`) instead.

## Path parameters

- `modelId` number, double, required

## Request body

- MatchBoosterConfigUpdate: The input for updating a model's Match Booster configuration. Omitted fields are left unchanged; `regions` and `columnMappings`, when provided, replace the stored set.
  - `enabled` boolean
  - `regions` MatchBoosterRegionConfig[]: The API supports a single Match Booster region per model (multi-region is an audience feature, and audiences are not configurable via the API), so exactly one entry must be provided.
    - `region` 'us' | 'eu', required: The Match Booster region this configuration applies to.
    - `householdExpansion` boolean: Expand targeting to people and devices sharing the same residential address. Not available in the EU region.
    - `ctvMatching` boolean: Match person and household records to third-party IP addresses and CTV IDs. Not available in the EU region.
    - `enrichmentSchedule` MatchBoosterEnrichmentSchedule: How often enrichment runs. The total interval may not exceed 28 days.
      - `interval` MatchBoosterEnrichmentInterval, required
        - `unit` 'hour' | 'day' | 'week', required
        - `quantity` integer, required
  - `columnMappings` MatchBoosterColumnMapping[]
    - `column` string, required: The name of the model column.
    - `idType` string, required: The Match Booster identifier type for the column, e.g. "email", "phone", "email_sha256". Validated against the supported identifier types at request time.

## Response `200`

Ok

- union
  - MatchBoosterConfig: A model's Match Booster configuration.
    - `enabled` boolean, required: Whether Match Booster enrichment is enabled for the model.
    - `settingsModelId` number, double, required: The model that carries the Match Booster settings. For audience models this is the parent model; configuration changes must target it directly.
    - `regions` MatchBoosterRegionConfig[], required
      - `region` 'us' | 'eu', required: The Match Booster region this configuration applies to.
      - `householdExpansion` boolean: Expand targeting to people and devices sharing the same residential address. Not available in the EU region.
      - `ctvMatching` boolean: Match person and household records to third-party IP addresses and CTV IDs. Not available in the EU region.
      - `enrichmentSchedule` MatchBoosterEnrichmentSchedule: How often enrichment runs. The total interval may not exceed 28 days.
        - `interval` MatchBoosterEnrichmentInterval, required
          - `unit` 'hour' | 'day' | 'week', required
          - `quantity` integer, required
    - `columnMappings` MatchBoosterColumnMapping[], required
      - `column` string, required: The name of the model column.
      - `idType` string, required: The Match Booster identifier type for the column, e.g. "email", "phone", "email_sha256". Validated against the supported identifier types at request time.
  - ValidateErrorJSON
    - `message` 'Validation failed', required
    - `details` object, required
  - 'Internal Server Error'

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Validation Failed
- `500`: Something went wrong

## Changes

- **2026-11-04** `7f9793951e4f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hightouch/apis/hightouch-api/changes/models/:modelId/match-booster/patch.md)

---

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