Send RCS (Multiple Recipients)

Bundles are used to send messages to multiple recipients simultaneously, which is ideal for group broadcasts or marketing campaigns. Note: If you want to send RCS to a single recipient, use the endpoint Conversation. A bundle contains information about the sending agent, content in the form of text or cards, and a list of recipients. This is the most effective way to reach a larger group of users with a single interactive message.

Quickstart #

💻

Quick Start (cURL)

curl -X POST https://api.ip1.net/v3/bundles \
  -H "Authorization: Bearer API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "brand": "My-Store-Inc",
  "agent": "Customer Service",
  "recipients": {
    "46700123456": {}
  },
  "reference": "INTERN-REF-001",
  "tags": [
    "shipping",
    "important"
  ],
  "type": "Carousel",
  "carousel": [
    {
      "title": "Summer Campaign 2026",
      "content": "Get 20% off all sunglasses!",
      "mediaUrl": "https://cdn.site.se/promo-sun.jpg",
      "type": 1,
      "order": 0
    },
    {
      "title": "Summer Sale 2026",
      "content": "Get 20% off all sunglasses!",
      "mediaUrl": "https://cdn.site.se/promo-sun.jpg",
      "type": 1,
      "order": 2
    },
  ],
  "suggestions": [
    {
      "text": "View selection",
      "type": 1,
      "order": 0,
      "url": "https://site.se/shop",
      "postbackData": "shop_click"
    },
    {
      "text": "Call the store",
      "type": 4,
      "order": 1,
      "phoneNumber": "468123456",
      "postbackData": "call_click"
    }
  ]
}'"

Call #

Endpoint: /bundles

Methodology: POST

Example of call data #

📋

Call data (JSON)

{
  "brand": "Min-Butik-AB",
  "agent": "Customer Service",
  "recipients": {
    "46700123456": {}
  },
  "reference": "INTERN-REF-001",
  "tags": [
    "shipping",
    "important"
  ],
  "type": "Carousel",
  "carousel": [
    {
      "title": "Summer Campaign 2026",
      "content": "Get 20% off all sunglasses!",
      "mediaUrl": "https://cdn.site.se/promo-sun.jpg",
      "type": 1,
      "order": 0
    },
    {
      "title": "Summer Sale 2026",
      "content": "Get 20% off all sunglasses!",
      "mediaUrl": "https://cdn.site.se/promo-sun.jpg",
      "type": 1,
      "order": 2
    },
  ],
  "suggestions": [
    {
      "text": "View selection",
      "type": 1,
      "order": 0,
      "url": "https://site.se/shop",
      "postbackData": "shop_click"
    },
    {
      "text": "Call the store",
      "type": 4,
      "order": 1,
      "phoneNumber": "468123456",
      "postbackData": "call_click"
    }
  ]
}

Fields for request data #

Field name	Description of the project	Required	Type	Example
brand	Your brand name	Yes	string	`"My Shop Ltd."`
agent	Your agent's name	Yes	string	”Customer service
recipients	Your recipient list	Yes	Object	”46700123456”: { ”name”: ”Kalle” }
content	The content of the message itself	Required if the type is ”Text”	string	”Hi {name}! Your order has now been shipped.”
type	Message type	Yes	String or number (enum)	”Carousel”
reference	Internal reference for bundle	No, it is not.	string	”INTERN-REF-001”
tags	A list of searchable tags for grouping the mailing	No, it is not.	Array	[”shipping”, ”important”]
carousel	A list of multiple cards that create a Carousel	Required if the type is ”Carousel”	Array	(See table below)
card	Contains image, headline, and text (Rich Card).	Required if the type is ”Card”	Object	(See table below)
suggestions	A list of interactive buttons.	No, it is not.	Array	(See table below)
uniqueId	Unique ID to avoid duplicates.	No, it is not.	string	”order-12345-id”

Field details `card` #

Field name	Description of the project	Required	Type	Example
title	The heading displayed at the top of the card.	Yes	string	”Spring Sale!”
content	The descriptive text on the card.	Yes	string	”We are emptying the warehouse now.”
type	Card type (2 for Rich Card in carousel).	Yes	Integer	2
order	Order in which cards are shown	Required if the ”Carousel” type is used	Integer	1
mediaUrl	URL to image or video (public link).	No, it is not.	URI	”https://site.se/image.jpg”

Field details `suggestions` #

Field name	Description of the project	Required	Type	Example
text	The text on the button.	Yes	string	”Shop now”
type	Action type (2=URL, 5=Share Location, 6=Call).	Yes	Integer	2
order	Determines the order suggestions are displayed.	Yes, with more than one suggestion	Integer	”2”
postbackData	The data you get back upon a click.	Yes	string	”track_sale_click”
URL	Target URL (required for type 2).	No, it is not.	string	”https://site.se/shop”
Title	Title for Show Location on Map and Calendar Event.	Required for types 5 and 3	string	”Our Store”
Description	Event description.	Required for Type 3	string	”Welcome for a haircut!”
Start Time	The start time for a calendar event.	Required for Type 3	string	”2026-07-01T14:30”
EndTime	The end time for a calendar event.	Required for Type 3	string	”2026-07-01T15:30”
Latitude	Latitude to display a location on a map.	Required at Type 5	string	”58.3944347”
Longitude	The longitude to display a location on a map.	Required at Type 5	string	”13.8601547,18”
PhoneNumber	The phone number being dialed when the button is pressed	Required at type 6	string	”46101606060”

Responsibility #

Example of response data #

📋

Response data (JSON)

{
  "id": "65eb3d14f1234567890abcdef",
  "brand": "My-Store-Inc",
  "agent": "Customer Service",
  "type": 2,
  "content": "Hello! Your order has now been shipped.",
  "card": {
    "title": "Order #12345",
    "content": "The package is expected to arrive tomorrow.",
    "mediaUrl": "https://cdn.site.se/package.jpg",
    "type": 1,
    "height": 2
  },
  "suggestions": [
    {
      "text": "Track package",
      "type": 1,
      "url": "https://frakt.se/track/123",
      "postbackData": "track_click",
      "order": 0
    }
  ],
  "sendDate": "2026-03-04T15:05:00Z",
  "uniqueId": "order-12345-id",
  "reference": "INTERN-REF-001",
  "created": "2026-03-04T15:03:02Z",
  "tags": ["shipping", "important"]
}

Fields for response data #

Field name	Description of the project	Type	Example
id	Bundle's unique ID.	string	`"65eb3d14f1234567890abcdef"`Hello.
brand	The brand used.	string	”My-Shop-Co”
agent	Your agent's name	string	”Customer service”
type	Message type (e.g., 1=Text).	Integer	1
content	The text content that was sent out.	string	”Hi {name}! Your order has now been shipped.”
sendDate	Dispatch time.	DateTime	”2026-03-04T15:05:00Z”
reference	Your optional free-text reference.	string	”INTERN-REF-001”
uniqueId	Your own ID for duplicate check.	string	”order-12345-id”
created	Timestamp when the mail was created in the system.	DateTime	”03/04/2026 3:03:02 PM UTC”
tags	Array of tags associated with the shipment.	Array	[”shipping”, ”important”]
card	Contains details for the sent card (if applicable).	Object	{…}
suggestions	List of buttons that were sent.	Array	[…]

_ga	Purpose: The primary Google Analytics cookie. It is used to distinguish unique users by assigning a randomly generated number as a client identifier. It helps calculate visitor, session, and campaign data.
_ga_PWZPL9SN6X	Purpose: A Google Analytics 4 (GA4) session cookie. It is used to maintain the session state and track technical details of your visit (like session ID and timestamps) specifically for our tracking ID.

Send RCS (Multiple recipients)

Introduction

Bundles

Conversations

Messages

Callbacks

Quickstart #

Call #

Example of call data #

Fields for request data #

Field details `card` #

Field details `suggestions` #

Responsibility #

Example of response data #

Fields for response data #

Send RCS (Multiple recipients)

Quickstart #

Call #

Example of call data #

Fields for request data #

Field details card #

Field details suggestions #

Responsibility #

Example of response data #

Fields for response data #

Field details `card` #

Field details `suggestions` #