Koywe
What's new
On this page
BreakingAPI

Colombian contacts now require an ID document

Published on

Until now, creating a Colombian contact through the API did not ask for a document. Since 20 Nov 2026, every Colombian contact (countrySymbol: "CO") needs an ID document. It is the same rule that already applies in Brazil, and the one the platform already enforced when creating a contact.

Before and now

BeforeNow
Creating a Colombian contact through the API with no documentIt was createdResponds 400 with CT00050
Creating the contact in the platformAlready asked for a documentNo change

What changes

  • When you create a Colombian contact, documentType and documentNumber are required.
  • When you edit it, the check runs again if you change the country or the document.
  • When you delete documents, the contact has to keep at least one of the accepted ones.

If the document is missing, the API responds 400 with code CT00050.

Accepted documents

DocumentdocumentType
Cédula de Ciudadanía (CC)CED_CIU
Cédula de Extranjería (CE)CED_EXT
Número de Identificación Tributaria (NIT)NIT
PassportPP

RC, NOP and DIE are not accepted for Colombian contacts. Each type is described in Contacts and bank accounts.

JSON
{
  "firstName": "Juan",
  "lastName": "Pérez",
  "countrySymbol": "CO",
  "businessType": "PERSON",
  "type": "PERSON",
  "documentType": "CED_CIU",
  "documentNumber": "1234567890"
}

Existing contacts

Colombian contacts you created without a document don’t change, and the API doesn’t reject them when you create an order. But an ACH or account-to-account payment to one of them is created and then fails, because registering the destination account requires the holder’s document.

What to do:

  • Send documentType and documentNumber when you create Colombian contacts.
  • If you already have Colombian contacts with no document, add one before you pay them by ACH or account to account: update the contact with documentType and documentNumber. Use those two fields; a document sent in documents[] when editing is not saved.