[HTTP POST] ~/contactLists/{contactListId}/import/{importJobId}/run
Description: Run an ImportJob for a specific ContactList, to start the batch Insert/Update process
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| contactListId |
ContactList Id |
integer |
Required |
| importJobId |
Import Job Id |
integer |
Required |
QueryString Parameters
Custom Events
This Endpoint supports executing Custom Events after it Inserts/Updates Contacts.
You can execute custom events by adding a 'customevents' parameter with a comma-seperated list of Custom Event names to the Request's QueryString.
For Example: If you'd like to run the SendWelcomeEmail and SendEventInvite Custom Events with the contacts that have been successfully inserted/updated via this Call, you can do so via:
contactLists/{contactListId}/import/{importJobId}/run + "?customevents=SendWelcomeEmail,SendEventInvite"
Match Values
This Endpoint supports updating all Contacts within a given ContactList who have properties that match a given set values.
You can specify what values to match on by adding the following to the Request's QueryString:
- Adding 'match' parameter with a comma-seperated list of the PropertyNames to match on.
- If using a PATCH call - by Adding each PropertyName and required value to match upon.
- If using a POST/PUT call, make sure the specified PropertyName is a property of the ContactDTO that's being passed as part of the body.
For Example: If you'd like to update all contacts who have a specific ReferanceAccountId and EmailAddress, you would do so via:
[PATCH] contactLists/{contactListId}/import/{importJobId}/run + "?match=ReferanceAccountId,Email&ReferanceAccountId=123456&Email=pgannon@customerminds.com"
[PUT] contactLists/{contactListId}/import/{importJobId}/run + "?match=ReferanceAccountId,Email"
Body: {
values: {
"ReferanceAccountId":123456,
"Email": "pgannon@customerminds.com"
"Mobile": "353871234567" // Value to be updated
}
}
Please refer to the given ContactList's Schema/Fields as a list of valid values.
Body Parameters
None
Response Information
Description
Successful Response - OK (200):
Status of the Import Job
Response Content : ImportJob
| Name | Description | Type | Additional information |
|---|---|---|---|
| Id |
The Id of the ImportJob |
integer |
None. |
| ContactListId |
The ContactList this ImportJob is attached to |
integer |
None. |
| InvalidEmailCount |
The number of Invalid Emails Addresses found by this Import Job |
integer |
None. |
| InvalidSmsCount |
The number of Invalid TextMessage Numbers found by this ImportJob |
integer |
None. |
| ProgressPercent |
The completion percent of this Import Job |
integer |
None. |
| CurrentStatus |
The current status of this Import Job |
string |
None. |
| StartDate |
When this ImportJob Started |
date |
None. |
| FinishDate |
When this ImportJob finished |
date |
None. |
| InsertedContacts |
How many new contacts were created as part of the ImportJob |
integer |
None. |
| UpdatedContacts |
How many existing contacts were updated as part of the ImportJob |
integer |
None. |
| DroppedContacts |
How many existing contacts were deleted as part of the ImportJob |
integer |
None. |
| NotUpdatedContacts |
How many existing contacts where NOT updated as part of the ImportJob |
integer |
None. |
| TotalContacts |
The Total number of contacts Inserted/Updated as part of this ImportJob |
integer |
None. |
Response Codes:
-
200 - OK
- The Import Job was kicked-off successfully.
-
401 - Unauthorized
- Request has been denied as it lacks valid Authentication credentials.
-
403 - Forbidden
- The user does not have the relevant permissions to perform this action.
-
404 - NotFound
- The specified Contactlist or ImportJob were not found.
-
500 - InternalServerError
- An error occurred while processing this request.
Formats
application/json, text/json
{
"Id": 1,
"ContactListId": 1,
"InvalidEmailCount": 1,
"InvalidSmsCount": 1,
"ProgressPercent": 1,
"CurrentStatus": "sample string 2",
"StartDate": "2025-11-14T16:20:52.4841747+00:00",
"FinishDate": "2025-11-14T16:20:52.4841747+00:00",
"InsertedContacts": 1,
"UpdatedContacts": 1,
"DroppedContacts": 1,
"NotUpdatedContacts": 1,
"TotalContacts": 1
}
application/csp-report
{"Id":1,"ContactListId":1,"InvalidEmailCount":1,"InvalidSmsCount":1,"ProgressPercent":1,"CurrentStatus":"sample string 2","StartDate":"2025-11-14T16:20:52.4841747+00:00","FinishDate":"2025-11-14T16:20:52.4841747+00:00","InsertedContacts":1,"UpdatedContacts":1,"DroppedContacts":1,"NotUpdatedContacts":1,"TotalContacts":1}
application/xml, text/xml
<ImportJob xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/W50API.Models.DTO"> <ContactListId>1</ContactListId> <CurrentStatus>sample string 2</CurrentStatus> <DroppedContacts>1</DroppedContacts> <FinishDate>2025-11-14T16:20:52.4841747+00:00</FinishDate> <Id>1</Id> <InsertedContacts>1</InsertedContacts> <InvalidEmailCount>1</InvalidEmailCount> <InvalidSmsCount>1</InvalidSmsCount> <NotUpdatedContacts>1</NotUpdatedContacts> <ProgressPercent>1</ProgressPercent> <StartDate>2025-11-14T16:20:52.4841747+00:00</StartDate> <TotalContacts>1</TotalContacts> <UpdatedContacts>1</UpdatedContacts> </ImportJob>