Update a Callback Profile by ID

PATCH Method

Kaleyra.io offers an API that enables you to edit and update the callback profile details based on the ID.

📘

Note:

PATCH Method allows passing in the API request only the attributes that need to be edited. All attributes not passed in the API request will retain their current value without any modification.

To edit and update the callback profile detail based on ID, perform the following steps:

Base URL

https://<api_domain>/v1/<SID>

API Domain and Value

api_domainValue
IN podapi.in.kaleyra.io
SG Podapi.kaleyra.io
EU Podapi.eu.kaleyra.io
NA podapi.na.kaleyra.ai

API request to edit and update the callback profile details

To edit and update the callback profile detail, use the /callback/profiles/<id> endpoint with the following request method:

Request Format

curl --location --request PATCH 'https://<api_domain>/v1/<sid>/callback/profiles/<id>' \
--header 'api-key: <api-key>' \
--header 'Content-Type: <content-type>' \
--data-raw '{
  "title":"<title>",
  "http_method": "<http_method>",
  "url": "<url>",
  "body": "{<body>}",
  "response_message": "<response_message>"
}'

The following table describes the parameter used for editing and updating callback profile details:

Parameter

Data Type

Description

Example

Mandatory

sid

String

Account SID (Security Identifier).

HXXXXXXX071IN

Yes

id

String

Callback Profile ID (Security Identifier).

SG_bxxxxxxf-2xx4-4xx9-8xx7-fxxxxxxxxxxa

Yes

api-key

String

API key generated from Kaleyra.io account.

Axxxxxxxxxxxxxxxxxxxxxxxxxxxx3

Yes

content-type

String

The format in which the data is sent.

application/json

Yes

title

String

The Callback Profile name.

  • *Note**: It should respect the following conditions:
  • Minimum three characters.
  • Only alphabet, numbers, spaces, hyphens, and underscores are allowed.

Callback_Profile_Test_2

No

http_method

String

The method type you want to use for the Callback Profile that you are updating.
Allowed HTTP Methods are:

  • GET
  • POST
  • PUT
  • DELETE

POST

No

url

String

The endpoint on which you want to receive a callback. It could be HTTP or HTTPS.

https://webhook.site/dxxxxxx9-bxx8-4xx2-9xx5-4xxxxxxxxxx8

No

body

Object

For POST and PUT methods, you need to provide the callback body. It should be in JSON format.

The body is defined by the callback profile requester who is updating the callback profile. For example, the callback profile updated for the Default - No Channel Selected, Dynamic Variable is not defined by default, it has to configure based on the requirements.

{"name":""}

No

response_message

String

The message you want to send to a requester when the Payload is successful.
It is specific to chatbots and can be used only with chatbots. It may contain replacers.

For example, when a request is made for Chatbot and if the payload is successful then you can update the message like, Thank you, {"name": "first_name"} and in response, it will be:
Thank you, John, according to the database.

Profile updated successfully!

No

📘

Note:

At least you must pass one of the parameters listed to get a successful response.

Sample Request

The following is the sample request:

curl --location --request PATCH 'https://api.in.kaleyra.io/v1/HXXXXXXX071IN/callback/profiles/SG_bxxxxxxf-2xx4-4xx9-8xx7-fxxxxxxxxxxa' \
--header 'api-key: Axxxxxxxxxxxxxxxxxxxxxxxxxxxx3' \
--header 'Content-Type: application/json' \
--data-raw '{
  "title":"Callback_Profile_Test_1",
  "http_method": "POST",
  "url": "https://webhook.site/dxxxxxx9-bxx8-4xx2-9xx5-4xxxxxxxxxx8",
  "body": "{"name":""}",
  "response_message": "Profile updated successfully!"
}'

Sample Success Response

The following is the sample success response for editing and updating the callback profile details:

{
    "code": "RBC024",
    "message": "Profile updated successfully",
    "data": {
        "status": "Success",
        "code": "KCLB2009",
        "message": "Profile updated successfully",
        "data": [
            {
                "profileId": "SG_bxxxxxxf-2xx4-4xx9-8xx7-fxxxxxxxxxxa"
            }
        ]
    },
    "error": {},
    "status": 200
}

Sample Failure Response

The following is a sample failure response:

{
    "code": "RBC302",
    "message": "Title already exists. Please provide a unique title",
    "data": {},
    "error": [
        {
            "body": "body/title and body/company_id must be unique"
        }
    ],
    "status": 400
}

For more information about response codes and statuses related to editing and updating callback profile details, see Response Codes and Statuses for Editing and Updating Callback Profile Details by ID.





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