---
title: "POST /v1/case"
method: POST
path: "/v1/case"
tags: ["CRM"]
---

# POST /v1/case

`POST /v1/case`

Create a new case in the CRM system

## Headers

- `X-Hub-Signature-256` string, required

## Request body

- CreateCase
  - `subject` string, required
  - `conversationId` string, conversation-id, required
  - `createdByMember` Member
    - `name` string, required
    - `email` string, email, required
  - `socialProfile` SocialProfile
    - `socialNetworkType` 'TWITTER' | 'FACEBOOK' | 'FACEBOOKPAGE' | 'LINKEDIN' | 'LINKEDINCOMPANY' | 'LINKEDINGROUP' | 'INSTAGRAM' | 'INSTAGRAMBUSINESS' | 'INSTAGRAMPERSONAL' | 'INSTAGRAMPROFESSIONAL' | 'INAPPCHAT' | 'WHATSAPP' | 'TIKTOKBUSINESS' | 'THREADS' | 'SMS' | 'TELEGRAM' | 'WECHAT' | 'YOUTUBECHANNEL' | 'UNKNOWN', required
    - `name` string
    - `externalId` string
    - `mediumIdentifier` MediumIdentifier
      - `type` 'URL' | 'PHONE' | 'EMAIL' | 'ID', required
      - `value` string, required
  - `contactProfile` ContactProfile, required
    - `socialNetworkType` 'TWITTER' | 'FACEBOOK' | 'FACEBOOKPAGE' | 'LINKEDIN' | 'LINKEDINCOMPANY' | 'LINKEDINGROUP' | 'INSTAGRAM' | 'INSTAGRAMBUSINESS' | 'INSTAGRAMPERSONAL' | 'INAPPCHAT' | 'WHATSAPP' | 'TIKTOKBUSINESS' | 'THREADS' | 'UNKNOWN', required
    - `id` string, contact-profile-id, required
    - `socialNetworkContactProfileId` string
    - `primaryIdentifier` string
    - `secondaryIdentifier` string
    - `pictureUrl` string, uri
  - `crmContact` CrmContact
    - `id` string, required
  - `contactAttributes` ContactAttribute[]
    - `attribute` string, required
    - `value` string
    - `identifier` string
  - `defaultContactAttributes` DefaultContactAttributes
    - `email` string, email
    - `phone` string
    - `language` string
    - `vip` boolean
    - `url` string, uri
    - `name` string
  - `metadata` CRMMetadata, required
    - `id` string, crm-id, required — CRM integration ID
    - `instanceUrl` string, uri, required — The instance URL provided by the customer
    - `sharedKey` SharedKey, required
      - `key` string, byte, required — base64-encoded shared secret that is GCM-AES256-encrypted using `nonce` and application shared key
      - `nonce` string, byte, required — base64-encoded nonce value
    - `expiresAt` string, date-time, required — Expiry time for the request

## Response `201`

Case created successfully

## Other responses

- `400` — Case creation failed
- `401` — Unauthorized

---

[API](https://skmtc.net/hootsuite/apis/hootsuite-apps-api.md) · [All operations](https://skmtc.net/hootsuite/apis/hootsuite-apps-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hootsuite/hootsuite-apps-api/versions/015e2672e012/schema)