---
title: "Add Campaign Disposition"
method: POST
path: "/v2/campaigns/{campaignId}/dispositions"
tags: ["Dispositions"]
---

# Add Campaign Disposition

`POST /v2/campaigns/{campaignId}/dispositions`

## Request

- Base URL: `https://api.carecycle.ai`
- URL: `https://api.carecycle.ai/v2/campaigns/{campaignId}/dispositions`
- Auth: API key in header `x-api-key`

Add a disposition to a campaign

## Path parameters

- `campaignId` string, uuid, required: Campaign ID

## Request body

- PostV2CampaignsCampaignIdDispositionsRequestBody
  - `dispositionId` string, uuid, required: Disposition ID to add
  - `enabled` boolean: Whether to enable
  - `snippetOverride` string, nullable

## Response `200`

POST /v2/campaigns/:campaignId/dispositions Positive response

- PostV2CampaignsCampaignIdDispositionsPositiveResponse
  - `id` string, uuid, nullable, required
  - `campaignId` string, uuid, nullable, required
  - `dispositionId` string, uuid, required
  - `enabled` boolean, required
  - `snippetOverride` string, nullable, required
  - `createdAt` string, date-time, nullable, required: Campaign disposition creation time. ISO 8601 timestamp
  - `updatedAt` string, date-time, nullable, required: Campaign disposition last update time. ISO 8601 timestamp
  - `disposition` object
    - `id` string, uuid, required
    - `createdAt` string, date-time, nullable, required: Disposition creation time. ISO 8601 timestamp
    - `updatedAt` string, date-time, nullable, required: Disposition last update time. ISO 8601 timestamp
    - `name` string, required
    - `clientId` string, uuid, nullable, required
    - `description` string, nullable, required
    - `defaultSnippet` string, nullable, required
    - `category` 'system' | 'feature' | 'library', required
    - `requiredCapability` string, nullable, required
    - `isImmutable` boolean, required
    - `isHidden` boolean, required
    - `shouldSeed` boolean, required
    - `isArchived` boolean, required
    - `availableForSoftphone` boolean, required
    - `outcomeType` 'contacted' | 'bad_contact' | 'no_contact' | 'voicemail' | 'sale' | 'no_sale' | 'callback' | 'dnc' | 'rewrite' | 'resolved' | 'unresolved' | 'disqualified' | 'abandoned' | 'null', nullable, required
  - `resolvedSnippet` string, nullable
  - `isImplicit` boolean, required: True for system/feature dispositions that are not stored in campaign_dispositions
  - `isEditable` boolean, required: True for library dispositions that can be enabled/disabled

## Other responses

- `400`: POST /v2/campaigns/:campaignId/dispositions Negative response 400
- `401`: POST /v2/campaigns/:campaignId/dispositions Negative response 401
- `403`: POST /v2/campaigns/:campaignId/dispositions Negative response 403
- `404`: POST /v2/campaigns/:campaignId/dispositions Negative response 404
- `409`: POST /v2/campaigns/:campaignId/dispositions Negative response 409
- `422`: POST /v2/campaigns/:campaignId/dispositions Negative response 422
- `429`: POST /v2/campaigns/:campaignId/dispositions Negative response 429
- `500`: POST /v2/campaigns/:campaignId/dispositions Negative response 500
- `502`: POST /v2/campaigns/:campaignId/dispositions Negative response 502
- `503`: POST /v2/campaigns/:campaignId/dispositions Negative response 503

---

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