Sample code for 30+ languages & platforms
Xbase++ Requires Chilkat v11.0.0+

Constant Contact V3: Restore a deleted contact to a list

See more Constant Contact Examples

Look up the deleted contact by email, then restore it by adding its existing ID to a chosen list. Constant Contact documents this membership activity as a restoration method. It changes only membership, preserves the saved profile, and makes no email-permission claim. Select the intended destination list explicitly; previous memberships were removed by deletion. Authorize the app first and use the same credential store.

Constant Contact developer guide

Chilkat Xbase++ Downloads

Xbase++
LOCAL nSuccess
LOCAL oVault
LOCAL oEntry
LOCAL oTokens
LOCAL nLoaded
LOCAL oHttp
LOCAL oResp
LOCAL oQuery
LOCAL oMatches
LOCAL oBody
LOCAL oJob
LOCAL cActivityId
LOCAL nAttempt
LOCAL cState
LOCAL i

nSuccess := 0

//  Assumes Chilkat is unlocked. See Global Unlock Sample.
oVault := CreateObject("Chilkat.Secrets")
oVault:Location := "local_manager"
oVault:AutoSplit := 1
oEntry := CreateObject("Chilkat.JsonObject")
oEntry:UpdateString("appName", "ConstantContactV3")
oEntry:UpdateString("service", "OAuth2")
oEntry:UpdateString("username", "my-account")
oTokens := CreateObject("Chilkat.JsonObject")
nLoaded := oVault:GetSecretJson(oEntry, oTokens)
IF (nLoaded != 1)
    ? "Run the desktop authorization example using this account and store."
    oVault:destroy()
    oEntry:destroy()
    oTokens:destroy()
    RETURN
ENDIF

IF (oTokens:JsonTypeOf("access_token") != 1)
    ? "The saved authorization has no access token."
    oVault:destroy()
    oEntry:destroy()
    oTokens:destroy()
    RETURN
ENDIF

oHttp := CreateObject("Chilkat.Http")
oHttp:RequireSslCertVerify := 1
oHttp:AuthToken := oTokens:StringOf("access_token")
oResp := CreateObject("Chilkat.HttpResponse")

oQuery := CreateObject("Chilkat.HttpRequest")
oQuery:HttpVerb := "GET"
oQuery:AddParam("email", "reader+newsletter@example.com")
oQuery:AddParam("status", "deleted")
nSuccess := oHttp:HttpReq("https://api.cc.email/v3/contacts", oQuery, oResp)
IF ((nSuccess != 1) .OR. (oResp:StatusCode != 200))
    ? "Expected HTTP 200. Received " + Str(oResp:StatusCode)
    IF (oResp:StatusCode == 401)
        ? "Refresh the saved access token or authorize again."
    ENDIF

    oVault:destroy()
    oEntry:destroy()
    oTokens:destroy()
    oHttp:destroy()
    oResp:destroy()
    oQuery:destroy()
    RETURN
ENDIF

oMatches := CreateObject("Chilkat.JsonObject")
nSuccess := oMatches:Load(oResp:BodyStr)
IF (nSuccess != 1)
    ? "Expected a JSON response."
    oVault:destroy()
    oEntry:destroy()
    oTokens:destroy()
    oHttp:destroy()
    oResp:destroy()
    oQuery:destroy()
    oMatches:destroy()
    RETURN
ENDIF

IF ((oMatches:SizeOfArray("contacts") != 1) .OR. (oMatches:JsonTypeOf("contacts[0].deleted_at") != 1))
    ? "Expected one deleted contact for this email. No restoration submitted."
    oVault:destroy()
    oEntry:destroy()
    oTokens:destroy()
    oHttp:destroy()
    oResp:destroy()
    oQuery:destroy()
    oMatches:destroy()
    RETURN
ENDIF

IF ((oMatches:JsonTypeOf("contacts[0].contact_id") != 1) .OR. (oMatches:StringOfEquals("contacts[0].contact_id", "", 1) == 1))
    ? "Missing contacts[0].contact_id in the response."
    oVault:destroy()
    oEntry:destroy()
    oTokens:destroy()
    oHttp:destroy()
    oResp:destroy()
    oQuery:destroy()
    oMatches:destroy()
    RETURN
ENDIF

oBody := CreateObject("Chilkat.JsonObject")
oBody:UpdateString("source.contact_ids[0]", oMatches:StringOf("contacts[0].contact_id"))
oBody:UpdateString("list_ids[0]", "DESTINATION_LIST_ID")
nSuccess := oHttp:HttpJson("POST", "https://api.cc.email/v3/activities/add_list_memberships", oBody, "application/json", oResp)
IF ((nSuccess != 1) .OR. (oResp:StatusCode < 200) .OR. (oResp:StatusCode >= 300))
    ? "Could not start the membership activity. HTTP " + Str(oResp:StatusCode)
    oVault:destroy()
    oEntry:destroy()
    oTokens:destroy()
    oHttp:destroy()
    oResp:destroy()
    oQuery:destroy()
    oMatches:destroy()
    oBody:destroy()
    RETURN
ENDIF

oJob := CreateObject("Chilkat.JsonObject")
nSuccess := oJob:Load(oResp:BodyStr)
IF (nSuccess != 1)
    ? "Expected a JSON response."
    oVault:destroy()
    oEntry:destroy()
    oTokens:destroy()
    oHttp:destroy()
    oResp:destroy()
    oQuery:destroy()
    oMatches:destroy()
    oBody:destroy()
    oJob:destroy()
    RETURN
ENDIF

IF ((oJob:JsonTypeOf("activity_id") != 1) .OR. (oJob:StringOfEquals("activity_id", "", 1) == 1))
    ? "Missing activity_id in the response."
    oVault:destroy()
    oEntry:destroy()
    oTokens:destroy()
    oHttp:destroy()
    oResp:destroy()
    oQuery:destroy()
    oMatches:destroy()
    oBody:destroy()
    oJob:destroy()
    RETURN
ENDIF

cActivityId := oJob:StringOf("activity_id")
? "Submitted activity ID: " + cActivityId
oHttp:SetUrlVar("job", cActivityId)
//  Poll briefly. A longer-running job can be checked later using the same ID.
nAttempt := 0
DO WHILE (nAttempt < 5)
    nSuccess := oHttp:HttpNoBody("GET", "https://api.cc.email/v3/activities/{$job}", oResp)
    IF ((nSuccess != 1) .OR. (oResp:StatusCode != 200))
        ? "Status check returned HTTP " + Str(oResp:StatusCode) + ". Keep the activity ID and check again later."
        oVault:destroy()
        oEntry:destroy()
        oTokens:destroy()
        oHttp:destroy()
        oResp:destroy()
        oQuery:destroy()
        oMatches:destroy()
        oBody:destroy()
        oJob:destroy()
        RETURN
    ENDIF

    nSuccess := oJob:Load(oResp:BodyStr)
    IF ((nSuccess != 1) .OR. (oJob:JsonTypeOf("state") != 1))
        ? "Missing activity state. Keep the activity ID."
        oVault:destroy()
        oEntry:destroy()
        oTokens:destroy()
        oHttp:destroy()
        oResp:destroy()
        oQuery:destroy()
        oMatches:destroy()
        oBody:destroy()
        oJob:destroy()
        RETURN
    ENDIF

    cState := oJob:StringOf("state")
    IF ((cState != "initialized") .AND. (cState != "processing"))
        ? "Activity state: " + cState
        i := 0
        DO WHILE (i < oJob:SizeOfArray("activity_errors"))
            oJob:I := i
            ? oJob:StringOf("activity_errors[i]")
            i := i + 1
        ENDDO
        oVault:destroy()
        oEntry:destroy()
        oTokens:destroy()
        oHttp:destroy()
        oResp:destroy()
        oQuery:destroy()
        oMatches:destroy()
        oBody:destroy()
        oJob:destroy()
        RETURN
    ENDIF

    nAttempt := nAttempt + 1
    IF (nAttempt < 5)
        oHttp:SleepMs(2000)
    ENDIF

ENDDO
? "Still processing. Recheck the activity ID before submitting another request."

oVault:destroy()
oEntry:destroy()
oTokens:destroy()
oHttp:destroy()
oResp:destroy()
oQuery:destroy()
oMatches:destroy()
oBody:destroy()
oJob:destroy()