---
title: "Account Notification Subscription Request"
method: POST
path: "/v1/crdr/subscription"
tags: ["Account Notification"]
---

# Account Notification Subscription Request

`POST /v1/crdr/subscription`

## Request

- Base URL: `https://tts.apib2b.citi.com/citiconnect/prod/accountstatementservices`
- URL: `https://tts.apib2b.citi.com/citiconnect/prod/accountstatementservices/v1/crdr/subscription`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/authenticationservices/v3/oauth/token`
- TypeScript: <https://skmtc.dev/citi/apis/account-notifications/docs/v1/crdr/subscription/post.ts> (a function with typed inputs; its response is checked against the schema)

Using this endpoint you can create, modify, or delete a subscription request and set parameters such as frequency and number of notifications.

## Query parameters

- `client_id` string, required

## Headers

- `Content-Type` string, required
- `Authorization` string, required

## Request body

- SubscriptionReqType
  - `requestType` 'CREATE' | 'MODIFY' | 'DELETE', required: Specifies the action to perform on the specified subscription. You can create, modify, or delete subscriptions, based on the request type.
  - `format` 'XML' | 'JSON', required: Specifies the format to use for notifications - XML or JSON.
  - `creditDebitIndicator` 'DBIT' | 'CRDT' | 'BOTH', required: The type of transaction for which you want notifications: * Credit * Debit * Both
  - `accountIdentification` string, required: The account number associated with the subscription.
  - `branchIdentification` string, required: Citi branch ID associated with the account.
  - `fromAmount` string: The minimum amount of a transaction to trigger a notification. Notifications will not be sent for transaction amounts below this threshold.
  - `toAmount` string: The maximium amount of a transaction to trigger a notification. Notifications will not be sent for transaction amounts above this limit.

## Response `200`

OK.

- SubscriptionResponse
  - `Info` string: Information for your request

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `405`: Method Not Allowed
- `415`: Unsupported Media Type
- `422`: Unprocessable Content
- `500`: Internal Server Error

## Changes

- **2026-11-06** `79414b28970e`: 11 breaking, 20 info
  - the request's body type changed from `object` to no type (media type: application/json)
  - the request property `accountIdentification` became required (media type: application/json)
  - the request property `accountIdentification` became required (media type: application/xml)
  - the request property `branchIdentification` became required (media type: application/json)
  - …27 more

[Operation history](https://skmtc.dev/citi/apis/account-notifications/changes/v1/crdr/subscription/post.md)

---

[API](https://skmtc.dev/citi/apis/account-notifications.md) - [All operations](https://skmtc.dev/citi/apis/account-notifications/llms.txt) - [OpenAPI document](https://skmtc.dev/citi/apis/account-notifications/revisions/79414b28970e?raw)