Demerge User Profile
Overview
This endpoint enables you to demerge a user profile.
Base URL
Here is an example base URL from the account in the India region:
https://in1.api.clevertap.com/1/demerge/profiles.json
Region
Refer Region for more details.
HTTP Method
POST
Headers
Refer Headers for more details.
Body Parameters
The body is uploaded as a JSON payload.
Parameter | Description | Required | Type | Example Value |
---|---|---|---|---|
identities | Custom user identity defined by you. A maximum of 100 identities are allowed in one request. | optional | string/array | [“client-19827239”, “[email protected]”] |
Below is an example payload.
{
"identities": ["client-19827239", "[email protected]"]
}
Example Request
Here is an example cURL request to the Demerge User Profile API showing the headers needed to authenticate the request from the account in the India region:
curl -X POST -d '{"identities":["client-19827239", "[email protected]"]}'
"https://in1.api.clevertap.com/1/demerge/profiles.json" \
-H "X-CleverTap-Account-Id: ACCOUNT_ID" \
-H "X-CleverTap-Passcode: PASSCODE" \
-H "Content-Type: application/json; charset=utf-8"
require 'net/http'
require 'uri'
require 'json'
uri = URI.parse("https://in1.api.clevertap.com/1/demerge/profiles.json")
request = Net::HTTP::Post.new(uri)
request.content_type = "application/json; charset=utf-8"
request["X-Clevertap-Account-Id"] = "ACCOUNT_ID"
request["X-Clevertap-Passcode"] = "PASSCODE"
request.body = JSON.dump({
"guid" => "df2e224d90874887b4d61153ef3a2508"
})
req_options = {
use_ssl: uri.scheme == "https",
}
response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
http.request(request)
end
import requests
headers = {
'X-CleverTap-Account-Id': 'ACCOUNT_ID',
'X-CleverTap-Passcode': 'PASSCODE',
'Content-Type': 'application/json; charset=utf-8',
}
data = '{"identities":["client-19827239", "[email protected]"]}'
response = requests.post('https://in1.api.clevertap.com/1/demerge/profiles.json', headers=headers, data=data)
<?php
include('vendor/rmccue/requests/library/Requests.php');
Requests::register_autoloader();
$headers = array(
'X-CleverTap-Account-Id' => 'ACCOUNT_ID',
'X-CleverTap-Passcode' => 'PASSCODE',
'Content-Type' => 'application/json; charset=utf-8'
);
$data = '{"identities":["client-19827239", "[email protected]"]}' ;
$response = Requests::post('https://in1.api.clevertap.com/1/demerge/profiles.json', $headers, $data);
var request = require('request');
var headers = {
'X-CleverTap-Account-Id': 'ACCOUNT_ID',
'X-CleverTap-Passcode': 'PASSCODE',
'Content-Type': 'application/json; charset=utf-8'
};
var dataString = '{"identities":["client-19827239", "[email protected]"]}';
var options = {
url: 'https://in1.api.clevertap.com/1/demerge/profiles.json',
method: 'POST',
headers: headers,
body: dataString
};
function callback(error, response, body) {
if (!error && response.statusCode == 200) {
console.log(body);
}
}
request(options, callback);
type Payload struct {
GUID string `json:"guid"`
}
data := Payload{
// fill struct
}
payloadBytes, err := json.Marshal(data)
if err != nil {
// handle err
}
body := bytes.NewReader(payloadBytes)
req, err := http.NewRequest("POST", "https://in1.api.clevertap.com/1/delete/profiles.json", body)
if err != nil {
// handle err
}
req.Header.Set("X-Clevertap-Account-Id", "ACCOUNT_ID")
req.Header.Set("X-Clevertap-Passcode", "PASSCODE")
req.Header.Set("Content-Type", "application/json; charset=utf-8")
resp, err := http.DefaultClient.Do(req)
if err != nil {
// handle err
}
defer resp.Body.Close()
Processing Time
The process runs only during the customer's non-business hours (4 AM to 7 AM of the account timezone).
Therefore,
- The processing of a single API request can take up to a day (24 hours).
- The processing of large number (million) of API requests can take a few days.
Example Response
{
"status": "success"
}
For more information on request limit, refer to API Request Limit.
To understand the common queries and concerns related to CleverTap APIs, refer to API FAQs.
Updated 25 days ago