API — Getting Started

Last updated: 01. January 2026

The configento.app API lets you manage configurator data programmatically — create, read and update features, options, prices and rules. Ideal when you want to transfer large amounts of data from a PIM or ERP system.

Authentication

All API requests are authenticated using an API token. Create API tokens in the V3 backend under Settings → API. Your service security key is visible in the Service Portal under Services.

Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

Base URL

https://api.configento.app/v1/

Resources

Components

GET    /components              # List all components
GET    /components/{id}         # Get a component
POST   /components              # Create new component
PUT    /components/{id}         # Update component
DELETE /components/{id}         # Delete component

Features

GET    /components/{id}/features           # All features of a component
POST   /components/{id}/features           # Create feature
PUT    /components/{id}/features/{fid}     # Update feature
DELETE /components/{id}/features/{fid}     # Delete feature

Options

GET    /features/{id}/options              # All options of a feature
POST   /features/{id}/options              # Create option
PUT    /features/{id}/options/{oid}        # Update option
DELETE /features/{id}/options/{oid}        # Delete option

Price Lists

GET    /components/{id}/pricelists         # Get price lists
POST   /components/{id}/pricelists         # Upload price list (CSV)
DELETE /components/{id}/pricelists/{plid}  # Delete price list

Example: Create a Feature

POST /components/123/features
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

{
  "name": "Colour",
  "type": "select",
  "required": true,
  "sort_order": 1,
  "options": [
    { "name": "White", "surcharge": 0 },
    { "name": "Anthracite", "surcharge": 15.00 },
    { "name": "RAL special lacquer", "surcharge": 45.00 }
  ]
}

Example: Upload a Price List

POST /components/123/pricelists
Authorization: Bearer YOUR_API_TOKEN
Content-Type: multipart/form-data

file: pricelist.csv
row_feature_id: 456
col_feature_id: 457

Rate Limiting

The API allows 1,000 requests per minute. If exceeded, status 429 Too Many Requests is returned.

Full API Documentation

The complete API reference with all endpoints, parameters and error codes is available under Settings → API → API documentation in the V3 backend.

Support

For API questions: support via the chat button in the Service Portal.

Next Steps

← All articles Try free for 14 days