Kimai icon

Kimai

Interact with Kimai time-tracking API

Customer → Create

AI-generated

Summary

Create a customer

Inputs

  • name (required) — Customer name
  • country (required) — Country
  • currency (required) — Currency
  • timezone (required) — Timezone
  • number — Customer number
  • comment — Comment
  • company — Company name
  • vatId — VAT identification number
  • contact — Contact person
  • addressLine1 — Address line 1
  • addressLine2 — Address line 2
  • addressLine3 — Address line 3
  • postcode — Postal code
  • city — City
  • phone — Phone number
  • fax — Fax number
  • mobile — Mobile phone number
  • email — Email address
  • homepage — Website URL
  • invoiceText — Invoice text
  • invoiceTemplate — Invoice template
  • buyerReference — Buyer reference
  • color — Color identifier
  • visible — Visibility flag
  • billable — Billable status
  • requestOptions — HTTP request configuration options

Output shape

customer object

Returns the created customer record including its generated ID and all provided fields.

Examples

Example 1: Create a new customer with required fields only

Name: Acme Corp; Country: Germany; Currency: EUR; Timezone: Europe/Berlin

Example 2: Create a customer with full details and enable batching

Name: Beta Ltd; Country: USA; Currency: USD; AddressLine1: 123 Main St; City: New York; RequestOptions: batching batchSize=100

Example 3: Create a customer and immediately retrieve it

After creation, use Get operation with the returned ID

Discussion