CkJava Requires Chilkat v11.0.0+
CkJava
SendGrid: Add or update list contacts and check the import job
See more SendGrid Examples
Use a Marketing Campaigns API key with contact access and the ID of an existing list. A 202 response queues the upsert; it does not confirm that the contacts were saved. Save the job ID and use it to recheck a pending import without submitting the contacts again. The error report may contain contact data; handle it privately.
Add or update contacts ยท Import job status
Chilkat CkJava Downloads
import com.chilkatsoft.*;
public class ChilkatExample {
static {
try {
System.loadLibrary("chilkat");
} catch (UnsatisfiedLinkError e) {
System.err.println("Native code library failed to load.\n" + e);
System.exit(1);
}
}
public static void main(String argv[])
{
boolean success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
success = false;
CkHttp http = new CkHttp();
http.put_RequireSslCertVerify(true);
// Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
http.put_AuthToken("SENDGRID_API_KEY");
CkHttpResponse resp = new CkHttpResponse();
String jobId = "";
if (jobId == "") {
CkJsonObject contacts = new CkJsonObject();
contacts.UpdateString("list_ids[0]","YOUR_LIST_UUID");
contacts.UpdateString("contacts[0].email","avery@example.com");
contacts.UpdateString("contacts[0].first_name","Avery");
contacts.UpdateString("contacts[1].email","robin@example.com");
contacts.UpdateString("contacts[1].first_name","Robin");
success = http.HttpJson("PUT","https://api.sendgrid.com/v3/marketing/contacts",contacts,"application/json",resp);
if (success != true) {
if (resp.get_StatusCode() == 0) {
System.out.println(http.lastErrorText());
}
else {
System.out.println("HTTP " + resp.get_StatusCode() + ": " + resp.bodyStr());
}
return;
}
if (resp.get_StatusCode() != 202) {
System.out.println("HTTP " + resp.get_StatusCode() + ": " + resp.bodyStr());
return;
}
CkJsonObject queued = new CkJsonObject();
success = queued.Load(resp.bodyStr());
if (success != true) {
System.out.println("Unexpected response: expected JSON.");
return;
}
if (queued.HasMember("job_id") != true) {
System.out.println("No job ID returned.");
return;
}
jobId = queued.stringOf("job_id");
System.out.println("Save this import job ID: " + jobId);
}
http.SetUrlVar("job",jobId);
success = http.HttpNoBody("GET","https://api.sendgrid.com/v3/marketing/contacts/imports/{$job}",resp);
if (success != true) {
if (resp.get_StatusCode() == 0) {
System.out.println(http.lastErrorText());
}
else {
System.out.println("HTTP " + resp.get_StatusCode() + ": " + resp.bodyStr());
}
return;
}
if (resp.get_StatusCode() != 200) {
System.out.println("HTTP " + resp.get_StatusCode() + ": " + resp.bodyStr());
return;
}
CkJsonObject job = new CkJsonObject();
success = job.Load(resp.bodyStr());
if (success != true) {
System.out.println("Unexpected response: expected JSON.");
return;
}
String state = job.stringOf("status");
if (state == "pending") {
System.out.println("Still pending. Check again later with jobId = " + jobId);
return;
}
System.out.println("Job status: " + state);
System.out.println("Created: " + job.IntOf("results.created_count") + ", updated: " + job.IntOf("results.updated_count") + ", errors: " + job.IntOf("results.errored_count"));
if ((state == "errored") || (state == "failed")) {
System.out.println("Review the job before retrying. If present, results.errors_url identifies the private error report.");
}
}
}