Create a new product

POST 
https://core-prod.malipopay.co.tz/api/v1/product

Creates a new product record for the project

Request

application/json

Body

Bodyrequired

namestringrequired
Product or service name
Example: Website Design Package
descriptionstring
Detailed description of the product
Example: Full responsive website with 5 pages
pricenumberrequired
Price of the product
Example: 1500000
currencystringrequired
Currency code
Example: TZS
categorystring
Product category
Example: Digital Services
unitstring
Unit of measure (e.g., piece, hour, month)
Example: project
taxableboolean
Whether this product is taxable
Example: true
activeboolean
Whether this product is currently active
Example: true

Example (auto)

{
  "name": "Website Design Package",
  "description": "Full responsive website with 5 pages",
  "price": 1500000,
  "currency": "TZS",
  "category": "Digital Services",
  "unit": "project",
  "taxable": true,
  "active": true
}

Responses

201

Product created successfully

application/json

Schema

Schema

_idstring
Example: 64d3ef701b4c8f2a0e6b3d92
namestring
Example: Website Design Package
descriptionstring
Example: Full responsive website with 5 pages
pricenumber
Example: 1500000
currencystring
Example: TZS
categorystring
Example: Digital Services
unitstring
Example: project
taxableboolean
Example: true
activeboolean
Example: true
projectstring
Project ID this product belongs to
Example: 63db68a6c5f3e7682e23c2ca
deletedboolean
Example: false
createdAtdate-time
Example: 2024-03-01T10:00:00.000Z
updatedAtdate-time
Example: 2024-03-01T10:00:00.000Z

Example (auto)

{
  "_id": "64d3ef701b4c8f2a0e6b3d92",
  "name": "Website Design Package",
  "description": "Full responsive website with 5 pages",
  "price": 1500000,
  "currency": "TZS",
  "category": "Digital Services",
  "unit": "project",
  "taxable": true,
  "active": true,
  "project": "63db68a6c5f3e7682e23c2ca",
  "deleted": false,
  "createdAt": "2024-03-01T10:00:00.000Z",
  "updatedAt": "2024-03-01T10:00:00.000Z"
}

400

Validation error

application/json

Schema

Schema

codeint32required
messagestringrequired

Example (auto)

{
  "code": 0,
  "message": "string"
}

500

Internal server error

application/json

Schema

Schema

codeint32required
messagestringrequired

Example (auto)

{
  "code": 0,
  "message": "string"
}

Authorization: apiToken

name: apiTokentype: apiKeyin: headerdescription: Project API key. Get yours from the Malipopay dashboard under Settings → API Keys.

• curl
• python
• nodejs
• php
• java
• go

• CURL

curl -L 'https://core-prod.malipopay.co.tz/api/v1/product' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'apiToken: <apiToken>' \
-d '{
  "name": "Website Design Package",
  "description": "Full responsive website with 5 pages",
  "price": 1500000,
  "currency": "TZS",
  "category": "Digital Services",
  "unit": "project",
  "taxable": true,
  "active": true
}'

Request

Base URL

https://core-prod.malipopay.co.tz

Auth

apiToken

Body required

{
  "name": "Website Design Package",
  "description": "Full responsive website with 5 pages",
  "price": 1500000,
  "currency": "TZS",
  "category": "Digital Services",
  "unit": "project",
  "taxable": true,
  "active": true
}

Response

Click the Send API Request button above and see the response here!