RCS Payload Specification

The following table describes the RCS API payload specifications:

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

Additional keys in message Ref1, Ref2, and Ref3 are passed in Mobile Terminated (MT) messages for reporting purpose.

255/key

255/key

255/key

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. A maximum of 200 characters is supported for Rich card and Carousel.

200

200

200

MAX_SIZE_RICHCARD_DESCRIPTION

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

2000

2000

2000

MAX_SIZE_EVENT_TITLE

Calendar field.

200

2048

200/2048

MAX_SIZE_EVENT_DESCRIPTION

Event description field.

2000

2048

2000/2048

MAX_SIZE_LOCATION_LABEL

Display text. That is available in locationAction > label.

200

200

200

MAX_SIZE_LOCATION_QUERY

Description text. That is available in locationAction > query.

2000

2000

2000

MIN_SIZE_CAROUSEL_CARDS

Minimum carousel cards in a message.

2

2

2

MAX_SIZE_CAROUSEL_CARDS

Maximum carousel cards in a message.

10

10

10

MAX_SIZE_URL

Clickable links in RBM payload.

4000

2048

4000

MAX_SIZE_CHIP_LIST_IN_CARD

Carousel message per card (for 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.