Skip to main content
POST
/
2023-11
/
admin
/
customers
Create
curl --request POST \
  --url https://api-staging.genuka.com/2023-11/admin/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_id": "01hqydxwtxdj3kmzp3bz7jk73g",
  "first_name": "Test",
  "last_name": "Test W",
  "medias": [
    {
      "name": "profile.jpg",
      "src": "https://genuka.com/logo.png"
    }
  ],
  "tags": [
    {
      "name": "tag 1"
    }
  ]
}
'
{
  "birthdate": null,
  "company_id": "01k7464hqksr4f99rp3ff7x2jz",
  "company_name": null,
  "created_at": "2025-10-09T13:37:12.000000Z",
  "custom_fields": [],
  "default_address": null,
  "deleted_at": null,
  "email": "[email protected]",
  "first_name": "Test",
  "gender": null,
  "id": "01k74k19r8cc6ksb89a1fnh6md",
  "last_activity": null,
  "last_name": "Test W",
  "medias": [
    {
      "collection_name": "default",
      "created_at": "2025-10-09T13:37:13.000000Z",
      "file_name": "logo.png",
      "id": 81,
      "large": "https://cdn.genuka.com/preprod_api_genuka/81/conversions/logo-large.jpg",
      "link": "https://cdn.genuka.com/preprod_api_genuka/81/logo.png",
      "micro": "https://cdn.genuka.com/preprod_api_genuka/81/conversions/logo-micro.jpg",
      "mime_type": "image/png",
      "size": 10830,
      "thumb": "https://cdn.genuka.com/preprod_api_genuka/81/conversions/logo-thumb.jpg",
      "updated_at": "2025-10-09T13:37:19.000000Z"
    }
  ],
  "metadata": {
    "matchingMediaIds": []
  },
  "phone": "+237 67812094",
  "preferred_language": null,
  "registration_number": null,
  "tax_number": null,
  "type": "individual",
  "updated_at": "2025-10-09T13:37:19.000000Z"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-company
string
Example:

"{{companyId}}"

Body

application/json
company_id
string
Example:

"01hqydxwtxdj3kmzp3bz7jk73g"

first_name
string
Example:

"Test"

last_name
string
Example:

"Test W"

medias
object[]
Example:
[
  {
    "name": "profile.jpg",
    "src": "https://genuka.com/logo.png"
  }
]
tags
object[]
Example:
[{ "name": "tag 1" }]

Response

200 OK

birthdate
unknown
company_id
string
Example:

"01k7464hqksr4f99rp3ff7x2jz"

company_name
unknown
created_at
string
Example:

"2025-10-09T13:37:12.000000Z"

custom_fields
any[]
Example:
[]
default_address
unknown
deleted_at
unknown
email
string
first_name
string
Example:

"Test"

gender
unknown
id
string
Example:

"01k74k19r8cc6ksb89a1fnh6md"

last_activity
unknown
last_name
string
Example:

"Test W"

medias
object[]
Example:
[
  {
    "collection_name": "default",
    "created_at": "2025-10-09T13:37:13.000000Z",
    "file_name": "logo.png",
    "id": 81,
    "large": "https://cdn.genuka.com/preprod_api_genuka/81/conversions/logo-large.jpg",
    "link": "https://cdn.genuka.com/preprod_api_genuka/81/logo.png",
    "micro": "https://cdn.genuka.com/preprod_api_genuka/81/conversions/logo-micro.jpg",
    "mime_type": "image/png",
    "size": 10830,
    "thumb": "https://cdn.genuka.com/preprod_api_genuka/81/conversions/logo-thumb.jpg",
    "updated_at": "2025-10-09T13:37:19.000000Z"
  }
]
metadata
object
phone
string
Example:

"+237 67812094"

preferred_language
unknown
registration_number
unknown
tax_number
unknown
type
string
Example:

"individual"

updated_at
string
Example:

"2025-10-09T13:37:19.000000Z"