Unicode C Requires Chilkat v11.0.0+
Unicode C
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 Unicode C Downloads
#include <C_CkHttpW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkJsonObjectW.h>
void ChilkatSample(void)
{
BOOL success;
HCkHttpW http;
HCkHttpResponseW resp;
const wchar_t *jobId;
HCkJsonObjectW contacts;
HCkJsonObjectW queued;
HCkJsonObjectW job;
const wchar_t *state;
success = FALSE;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
success = FALSE;
http = CkHttpW_Create();
CkHttpW_putRequireSslCertVerify(http,TRUE);
// Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
CkHttpW_putAuthToken(http,L"SENDGRID_API_KEY");
resp = CkHttpResponseW_Create();
jobId = L"";
if (jobId == L"") {
contacts = CkJsonObjectW_Create();
CkJsonObjectW_UpdateString(contacts,L"list_ids[0]",L"YOUR_LIST_UUID");
CkJsonObjectW_UpdateString(contacts,L"contacts[0].email",L"avery@example.com");
CkJsonObjectW_UpdateString(contacts,L"contacts[0].first_name",L"Avery");
CkJsonObjectW_UpdateString(contacts,L"contacts[1].email",L"robin@example.com");
CkJsonObjectW_UpdateString(contacts,L"contacts[1].first_name",L"Robin");
success = CkHttpW_HttpJson(http,L"PUT",L"https://api.sendgrid.com/v3/marketing/contacts",contacts,L"application/json",resp);
if (success != TRUE) {
if (CkHttpResponseW_getStatusCode(resp) == 0) {
wprintf(L"%s\n",CkHttpW_lastErrorText(http));
}
else {
wprintf(L"HTTP %d: %s\n",CkHttpResponseW_getStatusCode(resp),CkHttpResponseW_bodyStr(resp));
}
CkHttpW_Dispose(http);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(contacts);
return;
}
if (CkHttpResponseW_getStatusCode(resp) != 202) {
wprintf(L"HTTP %d: %s\n",CkHttpResponseW_getStatusCode(resp),CkHttpResponseW_bodyStr(resp));
CkHttpW_Dispose(http);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(contacts);
return;
}
queued = CkJsonObjectW_Create();
success = CkJsonObjectW_Load(queued,CkHttpResponseW_bodyStr(resp));
if (success != TRUE) {
wprintf(L"Unexpected response: expected JSON.\n");
CkHttpW_Dispose(http);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(contacts);
CkJsonObjectW_Dispose(queued);
return;
}
if (CkJsonObjectW_HasMember(queued,L"job_id") != TRUE) {
wprintf(L"No job ID returned.\n");
CkHttpW_Dispose(http);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(contacts);
CkJsonObjectW_Dispose(queued);
return;
}
jobId = CkJsonObjectW_stringOf(queued,L"job_id");
wprintf(L"Save this import job ID: %s\n",jobId);
}
CkHttpW_SetUrlVar(http,L"job",jobId);
success = CkHttpW_HttpNoBody(http,L"GET",L"https://api.sendgrid.com/v3/marketing/contacts/imports/{$job}",resp);
if (success != TRUE) {
if (CkHttpResponseW_getStatusCode(resp) == 0) {
wprintf(L"%s\n",CkHttpW_lastErrorText(http));
}
else {
wprintf(L"HTTP %d: %s\n",CkHttpResponseW_getStatusCode(resp),CkHttpResponseW_bodyStr(resp));
}
CkHttpW_Dispose(http);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(contacts);
CkJsonObjectW_Dispose(queued);
return;
}
if (CkHttpResponseW_getStatusCode(resp) != 200) {
wprintf(L"HTTP %d: %s\n",CkHttpResponseW_getStatusCode(resp),CkHttpResponseW_bodyStr(resp));
CkHttpW_Dispose(http);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(contacts);
CkJsonObjectW_Dispose(queued);
return;
}
job = CkJsonObjectW_Create();
success = CkJsonObjectW_Load(job,CkHttpResponseW_bodyStr(resp));
if (success != TRUE) {
wprintf(L"Unexpected response: expected JSON.\n");
CkHttpW_Dispose(http);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(contacts);
CkJsonObjectW_Dispose(queued);
CkJsonObjectW_Dispose(job);
return;
}
state = CkJsonObjectW_stringOf(job,L"status");
if (state == L"pending") {
wprintf(L"Still pending. Check again later with jobId = %s\n",jobId);
CkHttpW_Dispose(http);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(contacts);
CkJsonObjectW_Dispose(queued);
CkJsonObjectW_Dispose(job);
return;
}
wprintf(L"Job status: %s\n",state);
wprintf(L"Created: %d, updated: %d, errors: %d\n",CkJsonObjectW_IntOf(job,L"results.created_count"),CkJsonObjectW_IntOf(job,L"results.updated_count"),CkJsonObjectW_IntOf(job,L"results.errored_count"));
if ((state == L"errored") || (state == L"failed")) {
wprintf(L"Review the job before retrying. If present, results.errors_url identifies the private error report.\n");
}
CkHttpW_Dispose(http);
CkHttpResponseW_Dispose(resp);
CkJsonObjectW_Dispose(contacts);
CkJsonObjectW_Dispose(queued);
CkJsonObjectW_Dispose(job);
}