Create SMS Campaign Advanced Format

Back to API List Use this API to create an SMS campaign with advanced formatting using the specified experience flow and contact list.

Method	POST
Endpoint	`https://{{host}}/agentassist/api/v1/public/{{IID}}/campaign?campaignType=sms`
Content-Type	`application/json`
Authorization	`auth: {{JWT}}` See How to generate the JWT Token.
API Scope	Campaign Management

Path Parameters

Parameter	Description	Type
`host`	Environment URL. For example: `https://platform.kore.ai`	string, required
`IId`	The Application ID.	string, required

Query Parameters

Parameter	Description	Type
`campaignType`	Type of campaign. Use `"sms"`.	string, required

Sample Request

curl --location 'https://{{host}}/agentassist/api/v1/public/{{IID}}/campaign?campaignType=sms' \
--header 'auth: <token>' \
--header 'Content-Type: application/json' \
--header 'iid: st-0603182c-7ffb-53c3-b307-47ca14b9xxxx' \
--header 'accountId: 67777ce93e25326494e9xxxx' \
--data '{
    "name": "Interactive Support SMS Campaign",
    "description": "This campaign sends an SMS with a link or instructions to interact with a Platform. Customers can check order status, raise tickets, or get help—all via chat-enabled SMS.",
    "contactLists": [
     "Renewal Due - May/June 2025"
    ],
    "priority": "5",
    "format": "advanced",
    "campaignType": "sms",
    "dialingStrategy": {
        "callerId": {
            "phoneNumber": "+919876543210"
        },
        "callingHours": {
            "frequency": "WEEKLY",
            "timezone": "Asia/Kolkata",
            "days": [
                {
                    "day": "MO",
                    "start": "9:00 AM",
                    "end": "6:00 PM"
                },
                {
                    "day": "TU",
                    "start": "9:00 AM",
                    "end": "6:00 PM"
                },
                {
                    "day": "WE",
                    "start": "9:00 AM",
                    "end": "6:00 PM"
                },
                {
                    "day": "TH",
                    "start": "9:00 AM",
                    "end": "6:00 PM"
                },
                {
                    "day": "FR",
                    "start": "9:00 AM",
                    "end": "6:00 PM"
                }
            ]
        }
    },
    "schedule": {
        "isSchedulingEnabled": false
    },
    "experienceFlowName": "SMS Support Flow"
}'

Headers

Header	Description	Required/Optional
`auth`	JWT token for authentication.	required
`iid`	The Application Id.	required
`accountId`	The Account Id.	required

Body Parameters

Parameter	Description	Type
`name`	Name of the campaign.	string, required
`description`	Description of the campaign.	string, optional
`contactLists`	List of contact list names to use in the campaign.	array, required
`campaignType`	Type of campaign. Always `sms`.	string, required
`priority`	Campaign execution priority. For example, 5	string, optional
`format`	Message format. Use `simple`.	string, required
`message`	Message content.	object, required
`message.templateId`	Template ID for pre-configured message. Leave empty for plain message.	string, optional
`message.message`	Base64-encoded message content.	string, required
`dialingStrategy`	Calling strategy.	object, required
`dialingStrategy.callerId`	Caller ID details.	object, required
`dialingStrategy.callerId.phoneNumber`	Caller’s phone number in E.164 format.	string, required
`dialingStrategy.callingHours`	Permitted days and times.	object, required
`dialingStrategy.callingHours.frequency`	Frequency type. For example: `WEEKLY`.	string, required
`dialingStrategy.callingHours.timezone`	Time zone for the campaign. For example: `Asia/Kolkata`.	string, required
`dialingStrategy.callingHours.days`	List of day/time windows.	array, required
`dialingStrategy.callingHours.days.day`	Day of the week (`MO`, `TU`, `WE`, etc.).	string, required
`dialingStrategy.callingHours.days.start`	Start time (for example, `9:00 AM`).	string, required
`dialingStrategy.callingHours.days.end`	End time (for example, `6:00 PM`).	string, required
`schedule`	Scheduling settings.	object, optional
`schedule.isSchedulingEnabled`	Set to `false` to trigger the campaign immediately.	boolean, optional
`experienceFlowName`	Name of the associated experience flow.	string, required

Sample Response

{
    "status": "success",
    "message": "Campaign Interactive Support SMS Campaign creation in progress",
    "data": {
        "_id": "cd-3aefda80-f98e-5f4f-ad41-92803abbxxxx",
        "name": "Interactive Support SMS Campaign",
        "lname": "interactive support sms campaign",
        "description": "This campaign sends an SMS with a link or instructions to interact with a Platform. Customers can check order status, raise tickets, or get help—all via chat-enabled SMS.",
        "status": "Ready",
        "priority": "5",
        "dialingStrategy": {
            "callerId": {
                "phoneNumber": "+919876543210"
            },
            "callingHours": {
                "frequency": "WEEKLY",
                "timezone": "Asia/Kolkata",
                "days": [
                    {
                        "day": "MO",
                        "start": "9:00 AM",
                        "end": "6:00 PM"
                    },
                    {
                        "day": "TU",
                        "start": "9:00 AM",
                        "end": "6:00 PM"
                    },
                    {
                        "day": "WE",
                        "start": "9:00 AM",
                        "end": "6:00 PM"
                    },
                    {
                        "day": "TH",
                        "start": "9:00 AM",
                        "end": "6:00 PM"
                    },
                    {
                        "day": "FR",
                        "start": "9:00 AM",
                        "end": "6:00 PM"
                    }
                ]
            }
        },
        "experienceFlow": "cf-67447605-115e-5dd2-a676-e158cf3bxxxx",
        "createdAt": "2025-06-27T09:25:53.320Z",
        "updatedAt": "2025-06-27T09:25:53.320Z",
        "schedule": {
            "isSchedulingEnabled": false
        },
        "contactLists": [
            "Renewal Due - May/June 2025"
        ],
        "enableMachineDetect": false,
        "format": "advanced"
    }
}

Response Body Parameters

Parameter	Description	Type
`_id`	Unique identifier for the campaign.	string
`name`	Campaign name.	string
`lname`	Lowercase version of campaign name.	string
`description`	Campaign description.	string
`status`	Current campaign status. For example: `Ready`.	string
`priority`	Campaign priority. For example: `5`.	string
`dialingStrategy`	Dialing configuration for the campaign.	object
`dialingStrategy.callerId`	Caller ID configuration.	object
`dialingStrategy.callerId.phoneNumber`	Caller phone number in E.164 format.	string
`dialingStrategy.callingHours`	Allowed calling hours.	object
`dialingStrategy.callingHours.frequency`	Frequency of calls. Example: `WEEKLY`.	string
`dialingStrategy.callingHours.timezone`	Time zone used for calling hours.	string
`dialingStrategy.callingHours.days`	List of daily calling windows.	array
`dialingStrategy.callingHours.days.day`	Day of the week (for example, `MO`, `TU`).	string
`dialingStrategy.callingHours.days.start`	Start time (for example, `9:00 AM`).	string
`dialingStrategy.callingHours.days.end`	End time (for example, `6:00 PM`).	string
`experienceFlow`	Experience flow ID assigned.	string
`totalMessagesSent`	Count of messages sent.	integer
`direction`	Campaign format type. For example: `advanced`.	string
`createdAt`	Campaign creation timestamp in ISO format.	string
`updatedAt`	Last update timestamp in ISO format.	string
`schedule`	Scheduling settings for the campaign.	object
`schedule.isSchedulingEnabled`	Indicates if scheduling is enabled for the campaign.	boolean
`contactLists`	List of contact list names used in the campaign.	array
`enableMachineDetect`	Indicates if machine detection is enabled (not for SMS).	boolean
`data.format`	Specifies the message format (for example, `advanced`).	string

​Path Parameters

​Query Parameters

​Sample Request

​Headers

​Body Parameters

​Sample Response

​Response Body Parameters

Path Parameters

Query Parameters

Sample Request

Headers

Body Parameters

Sample Response

Response Body Parameters