POST /services/webshop/v1/categories/create Auth

Create Category

Request Body Required

Field	Type	Required	Example
`category_title`	string max: 255	Yes	`Electronics`
`category_url`	string max: 500	Yes	`electronics`
`status`	integer\|null 0, 1	No	`1`
`sort_number`	integer\|null min: 0	No	`1`
`main_image`	string\|null	No	`/images/electronics.jpg`
`templates`	integer\|null	No	`1`
`layout`	string\|null max: 191	No	`default`
`short_description`	string\|null	No	`Browse our wide selection of electronics`
`description`	string\|null	No	`<p>Discover the latest electronics at great prices.</p>`
`meta_title`	string\|null	No	`Electronics - Best Deals Online`
`meta_image`	string\|null	No	`/images/electronics-og.jpg`
`meta_description`	string\|null	No	`Shop electronics at unbeatable prices.`
`meta_keyword`	string\|null	No	`electronics, gadgets, tech`
`canonical_url`	string\|null	No	`https://example.com/electronics`
`no_index`	string\|null 0, 1	No	`0`
`disable_category_page`	string\|null 0, 1	No	`0`
`adwords_identifier`	number\|null	No	`123456789`
`product_sort_preference`	string\|null sort_number_asc, sort_number_desc, created_at_asc, created_at_desc, price_asc, price_desc, title_asc, title_desc	No	`sort_number_asc`
`sub_categories`	array\|null	No	`[]`

Responses

500

201

422

401

403

429

Internal server error

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`

Field	Type	Description
`error`	boolean
`message`	string
`details`	string

Resource created

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`

Field	Type	Description
`error`	boolean
`message`	string
`data`	object
`data.id`	integer
`data.platforms_id`	integer\|null
`data.website_id`	integer\|null
`data.title`	string\|null
`data.status`	string\|null
`data.url`	string\|null
`data.main_image`	string\|null
`data.sort_number`	integer\|null
`data.short_description`	string\|null
`data.description`	string\|null
`data.extra_description`	string\|null
`data.layout`	string\|null
`data.no_index`	string\|null
`data.meta_title`	string\|null
`data.meta_image`	string\|null
`data.meta_description`	string\|null
`data.meta_keyword`	string\|null
`data.created_at`	string\|null (date-time)
`data.updated_at`	string\|null (date-time)
`data.canonical_url`	string\|null
`data.sub_categories`	string\|null
`data.template_id`	integer\|null
`data.to_delete`	string\|null
`data.adwords_identifier`	string\|null
`data.disable_category_page`	integer
`data.product_sort_preference`	string\|null
`data.archived`	integer\|null
`data.archived_at`	string\|null (date-time)

Validation error

Field	Type	Description
`message`	string	Errors overview.
`errors`	object	A detailed description of each field that failed validation.

Unauthenticated — missing or invalid Bearer token

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`

Field	Type	Description
`error`	boolean
`message`	string

Forbidden — insufficient permissions for this resource

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`

Field	Type	Description
`error`	boolean
`message`	string

Too Many Requests — rate limit exceeded

Headers

Header	Type	Description	Example
`X-RateLimit-Limit`	integer	Maximum number of requests allowed per minute	`60`
`X-RateLimit-Remaining`	integer	Number of requests remaining in the current window	`57`
`Retry-After`	integer	Seconds until the rate limit resets	`60`

Field	Type	Description
`error`	boolean
`message`	string

Base URL

https://api.wemasy.nl/api

Authentication

Request Sample

cURL

PHP

Python

curl -X POST "https://api.wemasy.nl/api/services/webshop/v1/categories/create" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "category_title": "Electronics",
    "category_url": "electronics",
    "status": 1,
    "sort_number": 1,
    "main_image": "/images/electronics.jpg",
    "templates": 1,
    "layout": "default",
    "short_description": "Browse our wide selection of electronics",
    "description": "Discover the latest electronics at great prices.",
    "meta_title": "Electronics - Best Deals Online",
    "meta_image": "/images/electronics-og.jpg",
    "meta_description": "Shop electronics at unbeatable prices.",
    "meta_keyword": "electronics, gadgets, tech",
    "canonical_url": "https://example.com/electronics",
    "no_index": "0",
    "disable_category_page": "0",
    "adwords_identifier": 123456789,
    "product_sort_preference": "sort_number_asc",
    "sub_categories": []
}'

fetch('https://api.wemasy.nl/api/services/webshop/v1/categories/create', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Accept': 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "category_title": "Electronics",
    "category_url": "electronics",
    "status": 1,
    "sort_number": 1,
    "main_image": "/images/electronics.jpg",
    "templates": 1,
    "layout": "default",
    "short_description": "Browse our wide selection of electronics",
    "description": "Discover the latest electronics at great prices.",
    "meta_title": "Electronics - Best Deals Online",
    "meta_image": "/images/electronics-og.jpg",
    "meta_description": "Shop electronics at unbeatable prices.",
    "meta_keyword": "electronics, gadgets, tech",
    "canonical_url": "https://example.com/electronics",
    "no_index": "0",
    "disable_category_page": "0",
    "adwords_identifier": 123456789,
    "product_sort_preference": "sort_number_asc",
    "sub_categories": []
})})
.then(r => r.json())
.then(data => console.log(data));

$response = Http::withToken('YOUR_API_TOKEN')
    ->accept('application/json')
    ->post('https://api.wemasy.nl/api/services/webshop/v1/categories/create', {
    "category_title": "Electronics",
    "category_url": "electronics",
    "status": 1,
    "sort_number": 1,
    "main_image": "/images/electronics.jpg",
    "templates": 1,
    "layout": "default",
    "short_description": "Browse our wide selection of electronics",
    "description": "Discover the latest electronics at great prices.",
    "meta_title": "Electronics - Best Deals Online",
    "meta_image": "/images/electronics-og.jpg",
    "meta_description": "Shop electronics at unbeatable prices.",
    "meta_keyword": "electronics, gadgets, tech",
    "canonical_url": "https://example.com/electronics",
    "no_index": "0",
    "disable_category_page": "0",
    "adwords_identifier": 123456789,
    "product_sort_preference": "sort_number_asc",
    "sub_categories": []
});
$data = $response->json();

import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Accept": "application/json"
}
data = {
    "category_title": "Electronics",
    "category_url": "electronics",
    "status": 1,
    "sort_number": 1,
    "main_image": "/images/electronics.jpg",
    "templates": 1,
    "layout": "default",
    "short_description": "Browse our wide selection of electronics",
    "description": "Discover the latest electronics at great prices.",
    "meta_title": "Electronics - Best Deals Online",
    "meta_image": "/images/electronics-og.jpg",
    "meta_description": "Shop electronics at unbeatable prices.",
    "meta_keyword": "electronics, gadgets, tech",
    "canonical_url": "https://example.com/electronics",
    "no_index": "0",
    "disable_category_page": "0",
    "adwords_identifier": 123456789,
    "product_sort_preference": "sort_number_asc",
    "sub_categories": []
}
r = requests.post("https://api.wemasy.nl/api/services/webshop/v1/categories/create", headers=headers, json=data)
print(r.json())

Response Example

{
    "error": false,
    "message": "string",
    "data": {
        "id": 0,
        "platforms_id": 0,
        "website_id": 0,
        "title": "string",
        "status": "string",
        "url": "string",
        "main_image": "string",
        "sort_number": 0,
        "short_description": "string",
        "description": "string",
        "extra_description": "string",
        "layout": "string",
        "no_index": "string",
        "meta_title": "string",
        "meta_image": "string",
        "meta_description": "string",
        "meta_keyword": "string",
        "created_at": "string",
        "updated_at": "string",
        "canonical_url": "string",
        "sub_categories": "string",
        "template_id": 0,
        "to_delete": "string",
        "adwords_identifier": "string",
        "disable_category_page": 0,
        "product_sort_preference": "string",
        "archived": 0,
        "archived_at": "string"
    }
}

Try It

Request Body Required

Export