Batch merge profiles
Use this method to merge multiple person profiles belonging to the same user based on matching identifiers such as external ID, email, phone, and other contact information. The standard merge logic applies: the system selects a primary profile and consolidates fields and events from the secondary profiles into it. More information about the merge logic is available in the People documentation. <br>Any data included in the merge request overrides what is already stored. If the request provides a new external ID or new contact information, it is written into the resulting profile, either replacing the existing identifier or being added to the contact list, depending on the type. <br>If the merge request includes only new identifiers or contact information that match no existing profile, the system creates a new profile and populates it entirely with the data from the request. <br>Notes: <br>1. The batch size limit is 1000 persons. <br>2. Contact information in the request is checked only for formal validity (emails and phone numbers). Ensure its correctness, alignment with configured senders, and absence of errors.
Request
- Base URLhttps://api.infobip.com (the document declares no server; this is the origin it was published from)
- Auth
- OAuth 2Client credentialsToken URL: https://api.infobip.com/auth/1/oauth2/token
- or API key in header Authorization
- or API key in header Authorization
- or HTTP basic
Request body
Example request
{
"persons": [
{
"id": 1,
"externalId": "3",
"type": "CUSTOMER",
"firstName": "Jane",
"middleName": "Janie",
"lastName": "Smith",
"nickName": "Janey",
"country": "United Kingdom",
"city": "London",
"address": "67 Farringdon Road",
"gender": "FEMALE",
"preferredLanguage": "en-gb",
"birthDate": "1966-01-15",
"profilePicture": "http://profile.com",
"tags": [
"tag1",
"tag2"
],
"contactInformation": [
{
"type": "PHONE",
"identifier": "41793026727",
"sender": "41793026728",
"primary": true
}
],
"customAttributes": {
"Contract Expiry": "2024-06-12",
"Company": "ACME"
},
"computedAttributes": {
"fullName": "Jane Smith"
},
"createdFrom": "API",
"createdBy": "5",
"modifiedFrom": "API",
"modifiedBy": "5"
}
]
}Response
Multi-Status - Batch operation completed with individual results
Changes
No recorded changes to this operation across all 1 revision of this API.