---
title: "Add Customer Care Case"
method: POST
path: "/programs/{programCode}/customerCare/cases"
tags: ["CareCase"]
---

# Add Customer Care Case

`POST /programs/{programCode}/customerCare/cases`

Create customer support cases. How it works:
- The partner’s customer creates a case using their mobile app by calling POST programs/{programCode}/customerCare/cases.
- A new case for the customer is created in Salesforce for Green Dot’s agents, allowing them to handle the case.
- The partner receives the case number in their response details. The case number can also be displayed to the customer.

## Path parameters

- `programCode` string, required

## Headers

- `X-GD-RequestId` string, required

## Request body

- CareCaseRequest — Represents a request to create or update a care case. Contains customer details, question information, contact data, and device context. Inherits standard request metadata from Gd.Bos.DataTransfer.Request.RequestBase.
  - `subject` string, nullable — The subject or topic of the customer's question or issue.
  - `firstName` string, nullable — The first name of the user submitting the care case.
  - `lastName` string, nullable — The last name of the user submitting the care case.
  - `customerQuestion` string, nullable — The details of the question or issue provided by the customer.
  - `emailAddress` string, nullable — The email address of the user or customer.
  - `accountIdentifier` string, nullable — The unique identifier for the account associated with the care case.
  - `phoneNumbers` Phone — Represents a phone contact, including the phone number and its type. Used for storing and transferring phone contact information in requests and responses.
    - `number` string, nullable — The phone number, typically in E.164 or local format.
    - `type` 'None' | 'Mobile' | 'Work' | 'Home' — The type of phone number (e.g., Mobile, Work, Home).
  - `device` CaseDevice — Represents device information for a care case. Used to capture device context when a care case is submitted, including device identifiers, make, version, OS, and OS version.
    - `deviceID` string, nullable — The unique identifier of the device (e.g., serial number, UUID).
    - `deviceMake` string, nullable — The make or manufacturer of the device (e.g., Apple, Samsung).
    - `deviceVersion` string, nullable — The model or version of the device (e.g., iPhone 13, Galaxy S21).
    - `deviceOS` 'Web' | 'IOS' | 'Android' — The operating system type of the device (e.g., Web, IOS, Android).
    - `deviceOSVersion` string, nullable — The version of the device's operating system (e.g., iOS 16.1, Android 12).
  - `accountHolderIdentifier` string, nullable — The unique identifier for the account holder associated with the care case.

## Response `200`

OK

- CareCaseResponse — Represents the response returned after performing a care case operation. Contains the unique case number for tracking and reference. Inherits standard response metadata from Gd.Bos.DataTransfer.Response.ResponseBase.
  - `caseNumber` string, nullable — The unique case number assigned to the care case for tracking and reference.
  - `responseDetails` ResponseDetail[], nullable — Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.
    - `code` integer — The primary status or error code for the response (e.g., 200 for success, 400 for validation error).
    - `subCode` integer, nullable — An optional subcode providing more granular detail about the response or error.
    - `description` string, nullable — A human-readable description of the response, error, or status.
    - `url` string, nullable — A URL linking to documentation or a web page with more information about the response code.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/versions/666553766b78/schema)