RCS Payload Specification

The following table describes the RCS API payload specifications for messaging APIs:

Properties

Description

US Region

IN Region

Validated Data by Kaleyra

MAX_DEVICE_ADDRESSES

Device lookup limit per API call.

500

NA

500

MAX_SIZE_TEXT

Text character length.

2000

2500

2000

MAX_SIZE_REFERENCE_KEYS

Maximum number of characters allowed for the Ref1, Ref2, and Ref3 optional parameters passed in Mobile Terminated (MT) messages for reporting purpose.

255 for each parameter.

255 for each parameter.

255 for each parameter.

MAX_SIZE_CHIP_LIST

Maximum number of chips allowed per standalone message.

11

11

11

MAX_SIZE_POSTBACK_DATA

The maximum permitted size for the postbackData field. The limit is 400 characters for API requests and 120 characters for UI inputs.

1800
(Recommendation to use from Carrier is <=500 Characters).

120

2048

MAX_SIZE_RICHCARD_TITLE

Title field for Rich card. A maximum of 200 characters is supported for Rich card and Carousel.

200

200

200

MAX_SIZE_RICHCARD_DESCRIPTION

Description field for Rich Card. A maximum of 2000 characters is supported for Rich card and Carousel.

2000

2000

2000

MAX_SIZE_EVENT_TITLE

Maximum number of characters allowed for Calendar field.

200

2048

200/2048

MAX_SIZE_EVENT_DESCRIPTION

Maximum number of characters allowed for Event description field.

2000

2048

2000/2048

MAX_SIZE_LOCATION_LABEL

Maximum number of characters allowed for Display text, that is available in locationAction > label.

200

200

200

MAX_SIZE_LOCATION_QUERY

Maximum number of characters allowed for Description text, that is available in locationAction > query.

2000

2000

2000

MIN_SIZE_CAROUSEL_CARDS

Minimum required carousel cards in a carousel message.

2

2

2

MAX_SIZE_CAROUSEL_CARDS

Maximum number of allowed carousel cards in a carousel message.

10

10

10

MAX_SIZE_URL

Maximum length in characters of a Clickable links in RCS payload.

4000

2048

4000

MAX_SIZE_CHIP_LIST_IN_CARD

Maximum allowed number of Carousel message per rich card.

4

4

4

MAX_SIZE_CHIP

Chip title. A maximum of 25 characters is supported for the Chip title.

25

25

25






© 2026 Kaleyra Inc. All rights reserved.
Trademarks, logos and service marks displayed on this site are registered and unregistered trademarks of Kaleyra Inc.