❗️
Make sure you have the appropriate access control configured. For more information, see access group documentation.

API endpoint example

https://eu.api.capillarytech.com/v3/targetGroups/2163/targets/2317/communications/upsert

curl --location 'https://eu.api.capillarytech.com/v3/targetGroups/2750/targets/2996/communications/upsert' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic bWFkaHI3MjU2YQ==' \
--header 'Cookie: _cfuvid=H_OUDqsSJh7q7aUlkRgBjVIMRBFDNp2ic0PI6VAnYzw-1762857476978-0.0.1.1-604800000' \
--data-raw '[
  {
    "active": true,
    "channelId": 1,
    "communicationType": "START",
    "messageTemplate": "Test messageTemplate but communication type changed to START",
    "offsetDays": 1,
    "sender": "random.email123@example.com",
    "subjectTemplate": "Test subjectTemplate changed to START "

  }
]'

📘
The two path parameters targetGroupId and targetId are mandatory fields.

Body parameters

Parameter	Description
active	Pass true to make the communication active.
channelId	Unique ID of the channel through which the communication needs to be sent.
communicationType	Type of the communication. Values: START, FINISH, CHANGE, REMINDER.
messageTemplate	Content that should go in the message.
offsetDays
sender	Sender ID from which the communication needs to go.
subjectTemplate	Subject line of the template.

Example response

{
    "data": [
        {
            "id": 12,
            "attribution": {
                "createdOn": "2025-11-11T12:50:03.444+0000",
                "lastUpdatedOn": "2025-11-11T12:50:03.444+0000",
                "lastUpdatedBy": {
                    "id": 75197372,
                    "code": "madhu_rima",
                    "description": "madhurima's till",
                    "name": "madhurima",
                    "type": "TILL"
                },
                "createdBy": {
                    "id": 75197372,
                    "code": "madhu_rima",
                    "description": "madhurima's till",
                    "name": "madhurima",
                    "type": "TILL"
                }
            },
            "targetId": 2996,
            "targetGroupId": 2750,
            "communicationType": "START",
            "channelId": 1,
            "subjectTemplate": "Test subjectTemplate changed to START ",
            "messageTemplate": "Test messageTemplate but communication type changed to START",
            "sender": "random.email123@example.com",
            "offsetDays": 1,
            "active": true
        }
    ],
    "errors": null,
    "warnings": null
}

Response parameters

Parameter	Description
data	Array containing details of communication.
data[].id	Unique identifier of the communication.
data[].attribution	Contains metadata about the creation and last update of the communication.
data[].attribution.createdOn	Timestamp indicating when the communication was created, in ISO 8601 format, returned in the server time zone. EU server example 2025-11-11T12:50:03Z → 11 November 2025, 12:50:03 (UTC) India server example 2025-11-11T18:20:03+05:30 → 11 November 2025, 18:20:03 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
data[].attribution.lastUpdatedOn	Timestamp indicating the last update made to the communication, in ISO 8601 format, returned in the server time zone. EU server example 2025-11-11T12:50:03Z → 11 November 2025, 12:50:03 (UTC) India server example 2025-11-11T18:20:03+05:30 → 11 November 2025, 18:20:03 (IST) Note: The response time zone always matches the server time zone, regardless of the time zone offset in the request.
data[].attribution.lastUpdatedBy	Details of the entity or user that last updated the communication.
data[].attribution.lastUpdatedBy.id	Unique identifier of the last updater.
data[].attribution.lastUpdatedBy.code	Code related to the last updater.
data[].attribution.lastUpdatedBy.description	A description related to the last updater.
data[].attribution.lastUpdatedBy.name	Name of the last updater.
data[].attribution.lastUpdatedBy.type	Type of the last updater.
data[].attribution.createdBy	Details of the entity or user that created the communication.
data[].attribution.createdBy.id	Unique identifier of the creator.
data[].attribution.createdBy.code	Code related to the creator.
data[].attribution.createdBy.description	A description related to the creator.
data[].attribution.createdBy.name	Name of the creator.
data[].attribution.createdBy.type	Type of the creator.
data[].targetId	Identifier of the target for the communication.
data[].targetGroupId	Identifier of the target group for the communication.
data[].communicationType	Type of the communication.
data[].channelId	Unique ID of the channel through which the communication is sent.
data[].subjectTemplate	Subject line of the template for the communication.
data[].messageTemplate	Content/message template of the communication.
data[].sender	Sender ID from which the communication is sent.
data[].offsetDays	Number of days offset.
data[].active	Boolean indicating if the communication is active.
errors	Contains any errors related to the response.

200200

400400