---
title: "POST /v1/{+parent}/phraseMatchers"
method: POST
path: "/v1/{+parent}/phraseMatchers"
tags: ["projects"]
---

# POST /v1/{+parent}/phraseMatchers

`POST /v1/{+parent}/phraseMatchers`

Creates a phrase matcher.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudContactcenterinsightsV1PhraseMatcher — The phrase matcher resource.
  - `revisionCreateTime` string, google-datetime — Output only. The timestamp of when the revision was created. It is also the create time when a new matcher is added.
  - `updateTime` string, google-datetime — Output only. The most recent time at which the phrase matcher was updated.
  - `roleMatch` 'ROLE_UNSPECIFIED' | 'HUMAN_AGENT' | 'AUTOMATED_AGENT' | 'END_USER' | 'ANY_AGENT' — The role whose utterances the phrase matcher should be matched against. If the role is ROLE_UNSPECIFIED it will be matched against any utterances in the transcript.
  - `active` boolean — Applies the phrase matcher only when it is active.
  - `revisionId` string — Output only. Immutable. The revision ID of the phrase matcher. A new revision is committed whenever the matcher is changed, except when it is activated or deactivated. A server generated random ID will be used. Example: locations/global/phraseMatchers/my-first-matcher@1234567
  - `name` string — The resource name of the phrase matcher. Format: projects/{project}/locations/{location}/phraseMatchers/{phrase_matcher}
  - `phraseMatchRuleGroups` GoogleCloudContactcenterinsightsV1PhraseMatchRuleGroup[] — A list of phase match rule groups that are included in this matcher.
    - `type` 'PHRASE_MATCH_RULE_GROUP_TYPE_UNSPECIFIED' | 'ALL_OF' | 'ANY_OF' — Required. The type of this phrase match rule group.
    - `phraseMatchRules` GoogleCloudContactcenterinsightsV1PhraseMatchRule[] — A list of phrase match rules that are included in this group.
      - `query` string — Required. The phrase to be matched.
      - `negated` boolean — Specifies whether the phrase must be missing from the transcript segment or present in the transcript segment.
      - `config` GoogleCloudContactcenterinsightsV1PhraseMatchRuleConfig — Configuration information of a phrase match rule.
        - `exactMatchConfig` GoogleCloudContactcenterinsightsV1ExactMatchConfig — Exact match configuration.
          - `caseSensitive` boolean — Whether to consider case sensitivity when performing an exact match.
        - `regexMatchConfig` GoogleCloudContactcenterinsightsV1RegexMatchConfig — Regex match configuration.
  - `versionTag` string — The customized version tag to use for the phrase matcher. If not specified, it will default to `revision_id`.
  - `type` 'PHRASE_MATCHER_TYPE_UNSPECIFIED' | 'ALL_OF' | 'ANY_OF' — Required. The type of this phrase matcher.
  - `activationUpdateTime` string, google-datetime — Output only. The most recent time at which the activation status was updated.
  - `displayName` string — The human-readable name of the phrase matcher.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/contactcenterinsights.md) · [All operations](https://skmtc.net/google/apis/contactcenterinsights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/contactcenterinsights/revisions/e071ddf4dfc3/schema)