Colombian contacts now require an ID document
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
| Before | Now | |
|---|---|---|
| Creating a Colombian contact through the API with no document | It was created | Responds 400 with CT00050 |
| Creating the contact in the platform | Already asked for a document | No change |
What changes
- When you create a Colombian contact,
documentTypeanddocumentNumberare 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
| Document | documentType |
|---|---|
| Cédula de Ciudadanía (CC) | CED_CIU |
| Cédula de Extranjería (CE) | CED_EXT |
| Número de Identificación Tributaria (NIT) | NIT |
| Passport | PP |
RC, NOP and DIE are not accepted for Colombian contacts. Each type is described in Contacts and bank accounts.
{
"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
documentTypeanddocumentNumberwhen 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
documentTypeanddocumentNumber. Use those two fields; a document sent indocuments[]when editing is not saved.