[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

NameDescriptionTypeAdditional 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"

Body Parameters

None

Response Information

Description

Successful Response - OK (200):

Status of the Import Job

Response Content : ImportJob

NameDescriptionTypeAdditional 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

Sample: 
{
  "Id": 1,
  "ContactListId": 1,
  "InvalidEmailCount": 1,
  "InvalidSmsCount": 1,
  "ProgressPercent": 1,
  "CurrentStatus": "sample string 2",
  "StartDate": "2024-12-27T18:22:13.643685+00:00",
  "FinishDate": "2024-12-27T18:22:13.643685+00:00",
  "InsertedContacts": 1,
  "UpdatedContacts": 1,
  "DroppedContacts": 1,
  "NotUpdatedContacts": 1,
  "TotalContacts": 1
}

application/csp-report

Sample: 
{"Id":1,"ContactListId":1,"InvalidEmailCount":1,"InvalidSmsCount":1,"ProgressPercent":1,"CurrentStatus":"sample string 2","StartDate":"2024-12-27T18:22:13.643685+00:00","FinishDate":"2024-12-27T18:22:13.643685+00:00","InsertedContacts":1,"UpdatedContacts":1,"DroppedContacts":1,"NotUpdatedContacts":1,"TotalContacts":1}

application/xml, text/xml

Sample: 
<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>2024-12-27T18:22:13.643685+00:00</FinishDate>
  <Id>1</Id>
  <InsertedContacts>1</InsertedContacts>
  <InvalidEmailCount>1</InvalidEmailCount>
  <InvalidSmsCount>1</InvalidSmsCount>
  <NotUpdatedContacts>1</NotUpdatedContacts>
  <ProgressPercent>1</ProgressPercent>
  <StartDate>2024-12-27T18:22:13.643685+00:00</StartDate>
  <TotalContacts>1</TotalContacts>
  <UpdatedContacts>1</UpdatedContacts>
</ImportJob>