---
title: "Create New Outcome Mapping"
method: POST
path: "/campaigns/v1/outcome-mappings/{template}"
tags: ["Outcome Mappings"]
---

# Create New Outcome Mapping

`POST /campaigns/v1/outcome-mappings/{template}`

Create the outcome mapping configuration for the team's template.
- **template**: The template to create the outcome mapping for.
- **body**: The categories, sub categories, and mappings for the outcome configuration.

## Path parameters

- `template` 'template_v1' | 'template_v2', required

## Request body

- OutcomeMappingsCreateRequest
  - `categories` OutcomeCategory[], required — List of outcome categories
    - `name` string, required — Name of the outcome category
    - `theme` string, required — Theme of the outcome category
    - `description` string, nullable — Description of the outcome category
    - `displayOrder` integer — Lower values are displayed first.
  - `subCategories` OutcomeSubCategory[], required — List of outcome sub categories
    - `category_name` string, required — Name of the outcome category
    - `name` string, required — Name of the outcome sub category
    - `theme` string, required — Theme of the outcome sub category
    - `description` string, nullable — Description of the outcome sub category
    - `displayOrder` integer — Lower values are displayed first.
  - `mappings` OutcomeMapping[], required — List of outcome mappings
    - `outcome` string, required — Name of the outcome
    - `category_name` string, required — Name of the outcome category
    - `sub_category_name` string, nullable — Name of the outcome sub category

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-27** `a9901c64edf4` — 1 info
  - added the new enum value `template_v2` to the `path` request parameter `template`

[Change history](https://skmtc.dev/interactly/apis/interactly-api-2/changes/campaigns/v1/outcome-mappings/:template/post.md)

---

[API](https://skmtc.dev/interactly/apis/interactly-api-2.md) · [All operations](https://skmtc.dev/interactly/apis/interactly-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactly/interactly-api-2/revisions/a9901c64edf4/schema)