Skip to content
Leapa
Leapa.co
Sign in

Create a Product

POST https://api.leapa.co/v2/products

This endpoint needs your API key

Send it as a bearer token in the Authorization header. A request without one is answered with 401. See Authentication for where to find your key and how to keep it secret.

Request

curl -X POST "https://api.leapa.co/v2/products" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jeanne Ndayishimiye",
    "code": "string",
    "description": "Room 204, two nights",
    "type": "service",
    "status": "soldout",
    "images": [
      "string"
    ],
    "price_details": [
      {
        "price": 0,
        "currency": "BIF"
      }
    ],
    "attributes_hospitality_industry": {
      "bedType": "string",
      "numberOfGuests": 0,
      "amenities": [
        "AIR_CONDITIONING"
      ]
    },
    "rate_ids": [
      "string"
    ]
  }'

Response

Created

{
  "id": "obj_5f21c8a40b",
  "name": "Jeanne Ndayishimiye",
  "code": "string",
  "description": "Room 204, two nights",
  "status": "soldout",
  "type": "service",
  "images": [
    "string"
  ],
  "attributes": {
    "bedType": "string",
    "numberOfGuests": 0,
    "amenities": [
      "AIR_CONDITIONING"
    ]
  },
  "rateId": [
    "rat_20b6df3c9e"
  ],
  "created_date": 0,
  "price_details": [
    {
      "price": 0,
      "currency": "BIF"
    }
  ],
  "live": false,
  "rate_ids": [
    "string"
  ]
}

Request body

application/json

Required. Send it as JSON.

  • namestringrequired

    Name of the product. Constraints: Not null, Size(min=3, max=80)

    Must be:3 to 80 characters
  • codestringrequired

    Code of the product. Constraints: Not null, Size(min=3, max=20)

    Must be:3 to 20 characters
  • descriptionstringrequired

    Short description of the product. Constraints: Not null, Size(min=3, max=100)

    Must be:3 to 100 characters
  • typestringrequired

    Product type. Constraints: Not null

    Allowed values:servicegoodaddonstandardsingletriplequadsuiteand 10 more
  • statusstringrequired

    Status of the product.

    Allowed values:soldoutavailableunavailable
  • imagesarray of string

    List of images URL of the product

  • price_detailsarray of PriceDetailRequestrequired

    List of Product Price Details. Constraints: Not null

  • attributes_hospitality_industryProductAttribute
  • rate_idsarray of string

    List of Rate Id that can be applied to the product price.

Response

application/json
  • idstring

    Product ID

  • namestring

    Product Name

  • codestring

    Product Code

  • descriptionstring

    Product Description

  • statusstring

    Product Status

    Allowed values:soldoutavailableunavailable
  • typestring

    Product type

    Allowed values:servicegoodaddonstandardsingletriplequadsuiteand 10 more
  • imagesarray of string

    List of images URL of the product

  • attributesProductAttribute
  • rateIdarray of string
  • created_dateinteger<int64>

    Product creation time

  • price_detailsarray of PriceDetailResponse

    Detail of the price

  • liveboolean

    Whether is the production data or test data.

  • rate_idsarray of string

    Rate Id that will affect the product price.

Status codes

  • 201Created
  • 400Bad request
  • 401Unauthorized
  • 402Payment required
  • 403Forbidden
  • 404Not found
  • 428Precondition required
  • 500Server error

Request

curl -X POST "https://api.leapa.co/v2/products" \
  -H "Authorization: Bearer $LEAPA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jeanne Ndayishimiye",
    "code": "string",
    "description": "Room 204, two nights",
    "type": "service",
    "status": "soldout",
    "images": [
      "string"
    ],
    "price_details": [
      {
        "price": 0,
        "currency": "BIF"
      }
    ],
    "attributes_hospitality_industry": {
      "bedType": "string",
      "numberOfGuests": 0,
      "amenities": [
        "AIR_CONDITIONING"
      ]
    },
    "rate_ids": [
      "string"
    ]
  }'

Response

Created

{
  "id": "obj_5f21c8a40b",
  "name": "Jeanne Ndayishimiye",
  "code": "string",
  "description": "Room 204, two nights",
  "status": "soldout",
  "type": "service",
  "images": [
    "string"
  ],
  "attributes": {
    "bedType": "string",
    "numberOfGuests": 0,
    "amenities": [
      "AIR_CONDITIONING"
    ]
  },
  "rateId": [
    "rat_20b6df3c9e"
  ],
  "created_date": 0,
  "price_details": [
    {
      "price": 0,
      "currency": "BIF"
    }
  ],
  "live": false,
  "rate_ids": [
    "string"
  ]
}