This error occurs when a contact object fails validation during upsert operations. The error can result from one or more of the following issues: invalid correlation ID, incorrect phone number format, invalid country ISO code, or an improperly formatted postal code. Additionally, this error may also indicate an internal server issue during the upsert process.
INVALID_CORRELATION_ID: The correlation_id field is not a valid 32-character UUID. Each correlation_id should be a unique identifier, exactly 32 characters long, to map the response to the original request.
INVALID_COUNTRY_ISO_CODE: The country_iso_code is not a valid ISO 3166-1 alpha-2 country code. This field should be a 2-character uppercase string (e.g., "US" for the United States).
INVALID_CONTACT_ID: The contact_id field is not in the correct E.164 format.
INVALID_ZIP_CODE: The zip_code field is not a valid postal code. The zip code should conform to the format used in the corresponding country as indicated by the country_iso_code.
INTERNAL_SERVER_ERROR: This error indicates an internal server issue that caused the upsert process to fail. Please retry the request.
Ensure the correlation_id is a valid 32-character UUID. Each correlation_id must be unique across all contact objects. You can use a UUID generator if necessary.
Ensure the contact_id is a valid phone number in E.164 format.
Confirm the country_iso_code: Ensure the country_iso_code follows the ISO 3166-1 alpha-2 standard (e.g., "US").
Ensure the zip_code matches the postal code format for the specified country.
If an internal server error occurs, retry the request after some time.
Twilio's support team can help investigate what went wrong with upserting your contacts. Please collect 3 or more correlation_id from the last 24 hours that were flagged with Error 30647, and open a support request.