Updating custom fields with API

I have been pulling my hair out with trying to update contacts within a list using the bulk update method via API. We attempted to force the bulk import to process existing contacts by including an unchanged native/core field (last_name) that we fetched from each contact and sent back exactly as-is.

  • Payload included: email, existing last_name, and the cf: custom fields.

  • The API accepted the job (201 Created).

  • Activity completed quickly with percent_done: 100, error_count: 0.

    None of the CF fields were updated

    The only way we are getting this to work is update each record at a time and throttling to under 4 records a second. It takes a while for larger lists.

    Has anyone been able to get this to work with the bulk update method?

1 reply
Best reply by John B

Hello AllenI18,

My name is John and I am part of Constant Contact’s API Developer Support team. My team is here to assist outside software developers with questions about building into Constant Contact's API.

I have reviewed our logs for your bulk contact import requests and found that the reason the custom field values were not updated was due to a case sensitivity issue with the custom field names. To ensure that you have the correct capitalization for the custom field names, you can use the GET custom_fields Collection request for verification. I’m linking our documentation for this request below.

GET custom_fields Collection:

https://developer.constantcontact.com/api_reference/index.html#tag/Contacts-Custom-Fields/operation/getCustomFields

Please have a look and let us know if you have any other questions!

Regards,

John B.

Tier II API Support Engineer

View original
Webinar

Join our free, interactive event with expert Jay Schwedelson to learn data-backed strategies for high-performing subject lines. June 25, 2026

The world's largest virtual email marketing conference. November 12-13th.