Add Bulk Contact through File Upload

This API allows the user to add contacts in bulk to the CE panel.

Details

URL Schema:
US IDC:
https://api.netcoresmartech.com/apiv2

Indian IDC:
https://apiin.netcoresmartech.com/apiv2

EU IDC:
https://jsonapi.eu-north-1.eu.netcoresmartech.com/apiv2

Method:
POST

Header:

KeyValue
Content-Typeapplication/x-www-form-urlencoded

Parameters:

ParameterDescriptionData TypeRequiredParameter Type
activityActivity refers to the action that is being performed through the API, that is, add, delete, update, and so on.
Value here: bulkupload
StringYesQuery Parameter
pathThis refers to the complete path of the hosted .csv file which contains the contact data.

File path to private S3 buckets will work once Netcore IPs are whitelisted according to IDC region:
US - 44.199.15.1
Indian - 15.206.255.213
EU - 13.49.233.89
StringYesBody Parameter
listidEach list in CE has a unique ID assigned to it to identify. Passing this ID is required to let the API know to which list the contact is to be added.IntegerOptionalBody Parameter
apikeyYou can obtain the API key from the CE panel. Log in to your CE panel and go to Admin. Enable the API Mode in Account Configuration under Advance details. Now, go to Sub Admin and click Edit on your user name. You can view your API key here.stringYesQuery Parameter
typeIt represents the module or group the API belongs to. For example, if the API 's functionality is related to Contacts, type is 'contact'.

value here: contact
stringYesQuery Parameter
notifyemailOnce the bulk upload request is triggered, the upload process begins in the background. You may want to get notified when the upload is completed. This is the email ID to which the notification email is sent.stringOptional
callbackThis refers to the ping back URL to receive status of upload job.stringOptional

Request:
Request URL:

https://api.netcoresmartech.com/apiv2?type=contact&activity=bulkupload&apikey=xxxxxxxxxxxxxxxxxxxxxxxxxxx&path=<PATH OF YOUR FILE>&listid=33&[email protected]&callback=<URL>

Response: 200 OK

{
    "requestid": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "result": "Success"
}

🚧

Success Status (200)

This API is asynchronous, so a successful status does not guarantee job completion. Track job status using the endpoint in the callback key or the email in notifyemail key.