# Create a  case

Cases are used to collect or transmit additional information between Partners and Wise. Use this endpoint to create a new case.
Please do not include PII in the `subject` of a case. Any specific details regarding the case that need to be communicated should be included in the `description`.

Endpoint: POST /cases
Version: 2027Q1
Security: ClientCredentialsToken

## Security:

  - `ClientCredentialsToken` (unknown)
    http bearer JWT

## Header parameters:

  - `X-External-Correlation-Id` (string)
    Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. [Learn more](/guides/developer/headers/correlation-id).

## Request fields (application/json):

  - `type` (string)
    Type of the case. Value must be `GENERAL_ENQUIRY`. More case types will be added in the future.
    Example: GENERAL_ENQUIRY

  - `subject` (string)
    The subject of the case. Do not include PII in the subject of cases.
    Example: Inquiry about Transfer 12345

  - `details` (object)
    Details related to the case.

  - `details.transferId` (integer | null)
    ID of the transfer the case relates to. Can also be `null`.
    Example: 58114690

  - `details.profileId` (integer | null)
    ID of the profile the case relates to. Can also be `null`.
    Example: 14556049

  - `details.userId` (integer)
    ID of the user the case relates to. Can not be `null`.
    Example: 1234

  - `externalId` (string)
    An ID provided by the external partner for partner internal tracking.
    Example: partner_external_id_12345

  - `description` (string)
    The description of the request. The maximum size of the description is 65,535 characters. If additional characters are sent, the field will be truncated.
    Example: Initial summary of the issue

## Response 200:

  - `200` (unknown)
    Created case.

## Response 200 fields (application/json):

  - `id` (integer)
    Case ID. Generated by Wise.
    Example: 123456789

  - `status` (string)
    Status of the case
    Enum: "CREATING", "PENDING"

  - `type` (string)
    Type of the case. More case types will be added in the future.
    Enum: "GENERAL_ENQUIRY"

  - `externalId` (string)
    An ID provided by the external partner for partner internal tracking.
    Example: partner_12344567

  - `createdAt` (string)
    When the  case was originally created.
    Example: 2023-06-28T15:21:24.901

  - `updatedAt` (string)
    When the case was last updated.
    Example: 2023-06-28T15:21:24.901

## Response 200 headers (application/json):

  - `X-External-Correlation-Id` (string)
    Echoed back when `X-External-Correlation-Id` was included in the request. [Learn more](/guides/developer/headers/correlation-id).
    Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

  - `x-trace-id` (string)
    Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.
    Example: fba501b6d453b96789f52338f019341f

## Response 429:

  - `429` (unknown)
    Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

## Response 429 headers (application/json):

  - `Retry-After` (integer)
    Number of seconds to wait before retrying the request.
    Example: 5

  - `X-Rate-Limited-By` (string)
    Identifies the rate limiter that triggered the 429 response.
    Example: wise-public-api

  - `X-External-Correlation-Id` (string)
    Echoed back when `X-External-Correlation-Id` was included in the request. [Learn more](/guides/developer/headers/correlation-id).
    Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

  - `x-trace-id` (string)
    Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.
    Example: fba501b6d453b96789f52338f019341f