DIdigitax
Customers

Save business customer

Creates a customer record for the authenticated business using the supplied customer details.

post/customers

Request

  • Base URL
    https://api.digitax.tech/ke/v2
  • Auth
    API key in header X-API-Key

Request body

customer_namestring required

The name of the customer.

customer_tinstring required

The customer's Tax Identification Number (TIN) - an 11-character KRA PIN consisting of a leading A or P, 9 digits, and a trailing letter.

emailstring

The customer's email address.

phonestring

The customer's phone number.

Example request

{
  "customer_name": "John Doe",
  "customer_tin": "P012345678P",
  "email": "john@doe.com"
}

Response

Success

idstring required

The DigiTax ID of the customer.

customer_namestring required

The customer's name.

emailstring

The customer's email address.

phonestring

The customer's phone number.

customer_tinstring required

The customer's Tax Identification Number (TIN).

taxpayer_type'INDIVIDUAL' | 'BUSINESS' required

The taxpayer type, derived from the TIN prefix - P is BUSINESS, all other prefixes are INDIVIDUAL.

Example response

{
  "id": "customer_01HC3HTDAXQ50E07CWR2A2CFBD",
  "customer_name": "John Doe",
  "email": "john@doe.com",
  "customer_tin": "P012345678P",
  "taxpayer_type": "INDIVIDUAL"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.