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

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 Go Downloads

Go
    success := false

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = false
    http := chilkat.NewHttp()
    http.SetRequireSslCertVerify(true)
    //  Supply your API key from protected configuration; AuthToken adds the Bearer prefix.
    http.SetAuthToken("SENDGRID_API_KEY")
    resp := chilkat.NewHttpResponse()

    var jobId *string = new(string)
    *jobId = ""
    if *jobId == "" {
        contacts := chilkat.NewJsonObject()
        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.StatusCode() == 0 {
                fmt.Println(http.LastErrorText())
            } else {
                fmt.Println("HTTP ", resp.StatusCode(), ": ", resp.BodyStr())
            }

            http.DisposeHttp()
            resp.DisposeHttpResponse()
            contacts.DisposeJsonObject()
            return
        }

        if resp.StatusCode() != 202 {
            fmt.Println("HTTP ", resp.StatusCode(), ": ", resp.BodyStr())
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            contacts.DisposeJsonObject()
            return
        }

        queued := chilkat.NewJsonObject()
        success = queued.Load(resp.BodyStr())
        if success != true {
            fmt.Println("Unexpected response: expected JSON.")
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            contacts.DisposeJsonObject()
            queued.DisposeJsonObject()
            return
        }

        if queued.HasMember("job_id") != true {
            fmt.Println("No job ID returned.")
            http.DisposeHttp()
            resp.DisposeHttpResponse()
            contacts.DisposeJsonObject()
            queued.DisposeJsonObject()
            return
        }

        jobId = queued.StringOf("job_id")
        fmt.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.StatusCode() == 0 {
            fmt.Println(http.LastErrorText())
        } else {
            fmt.Println("HTTP ", resp.StatusCode(), ": ", resp.BodyStr())
        }

        http.DisposeHttp()
        resp.DisposeHttpResponse()
        contacts.DisposeJsonObject()
        queued.DisposeJsonObject()
        return
    }

    if resp.StatusCode() != 200 {
        fmt.Println("HTTP ", resp.StatusCode(), ": ", resp.BodyStr())
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        contacts.DisposeJsonObject()
        queued.DisposeJsonObject()
        return
    }

    job := chilkat.NewJsonObject()
    success = job.Load(resp.BodyStr())
    if success != true {
        fmt.Println("Unexpected response: expected JSON.")
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        contacts.DisposeJsonObject()
        queued.DisposeJsonObject()
        job.DisposeJsonObject()
        return
    }

    state := job.StringOf("status")
    if *state == "pending" {
        fmt.Println("Still pending. Check again later with jobId = ", *jobId)
        http.DisposeHttp()
        resp.DisposeHttpResponse()
        contacts.DisposeJsonObject()
        queued.DisposeJsonObject()
        job.DisposeJsonObject()
        return
    }

    fmt.Println("Job status: ", *state)
    fmt.Println("Created: ", job.IntOf("results.created_count"), ", updated: ", job.IntOf("results.updated_count"), ", errors: ", job.IntOf("results.errored_count"))
    if (*state == "errored") || (*state == "failed") {
        fmt.Println("Review the job before retrying. If present, results.errors_url identifies the private error report.")
    }


    http.DisposeHttp()
    resp.DisposeHttpResponse()
    contacts.DisposeJsonObject()
    queued.DisposeJsonObject()
    job.DisposeJsonObject()