Examples by country
➕ Create a new account
In order to create a new colombian account, you will need to send both the colombian RUT FORM, and the test_set_id as an additional field, that you can get from the DIAN website. Remember to get the token from the /auth endpoint first.
The test_set_id is a string and the registration_form_rut must be a PDF file encoded as base 64. Example page to convert PDF to base64: https://base64.guru/converter/encode/pdf
The field company_logo only supports PNG format and must be uploaded as base64.
Create account
- Endpoint: https://api-billing.koywe.com/V1/accounts
- Method: POST
- Required headers:
- Content-Type: application/json
- Authorization: Bearer \<token>
- Accept: */*
{
"country_id": 66,
"contact_name": "fernando rojas",
"contact_phone": "+579841055220",
"admin_email": "[email protected]",
"admin_password": "nuevaclave",
"registration_legal_name_company": "my company",
"registration_tax_id_code": "1707975798-1",
"registration_tax_id_type": "CO-NIT",
"registration_company_size": 1,
"registration_company_industry_sector": "1",
"registration_type_use": 1,
"registration_terms_of_use": 1,
"registration_additional_data": {
"registration_test_set_id": "AFAFDDSDFSFSAFADSFDSFDFSDA",
"registration_form_rut": "BRTR/V4fOjwxdWDl8YHT7/tP/4sua29LHlU86L9PcdPlrmoR/6YAF/0YkERyCg...",
"company_logo": "SOIFsDCCA5igAwIBAgIUMzAwMDEw..."
}
}
Notes: registration_test_set_id and registration_form_rut are just examples and don't show a full valid test_set_id and PDF form.
API Reference POST /accounts
Detailed endpoint documentation: /english/billing/api-reference/billing-api/🏢-accounts/create-a-new-account