---
title: "Upsert Notification Recipient Mapping Route"
method: PUT
path: "/api/notifications/recipient-mappings"
tags: ["notifications"]
---

# Upsert Notification Recipient Mapping Route

`PUT /api/notifications/recipient-mappings`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/notifications/recipient-mappings`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Request body

- union
  - CrmOwnerRecipientMappingPayload
    - `owner_id` string, required
    - `play_id` string, nullable
    - `provider` 'hubspot', required
    - `ref_kind` 'crm_owner', required
    - `slack_team_id` string, nullable
    - `slack_user_id` string, required
  - OrgMemberRecipientMappingPayload
    - `play_id` string, nullable
    - `ref_kind` 'org_member', required
    - `slack_team_id` string, nullable
    - `slack_user_id` string, required
    - `user_id` string, required

## Response `200`

Successful Response

- union
  - CrmOwnerRecipientMappingDto
    - `owner_id` string, required
    - `play_id` string, nullable, required
    - `provider` 'hubspot', required
    - `ref_id` string, required
    - `ref_kind` 'crm_owner', required
    - `slack_team_id` string, required
    - `slack_user_id` string, required
    - `user_id` unknown, required
  - OrgMemberRecipientMappingDto
    - `owner_id` unknown, required
    - `play_id` string, nullable, required
    - `provider` unknown, required
    - `ref_id` string, required
    - `ref_kind` 'org_member', required
    - `slack_team_id` string, required
    - `slack_user_id` string, required
    - `user_id` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)