Authentication

As already described in Authentication, each request needs a valid access_token which once retrieved is valid for 30 minutes. Use Get Access Token request to retrieve a valid access_token.

📄️ Introduction

The Propeller REST API is based on resource-oriented URL's, returns JSON-encoded responses and uses standard HTTP response codes, authentication and HTTP methods. The main goal of the REST API is efficiently importing/exporting large amounts of data in/out of the Propeller platform.

📄️ Add Setting to Cluster Config

Use this endpoint to add additional settings to a cluster config. If a cluster config setting is successfully created, the response will include the `id`.

🗃️ attribute-descriptions

7 items

🗃️ attributes

5 items

🗃️ authentication

2 items

📄️ Authentication

Authentication

📄️ Bulk Categories by Id

The bulk endpoints offer an efficient way of importing/updating large amounts of categories with just a single API call. When using the bulk `id` endpoint, the categories are identified by Propeller category `id`. If a category with such `id` doesn't already exist, it will be created. If it does exist, the category will be updated.

📄️ Bulk Categories by sourceId

The bulk endpoints offer an efficient way of importing/updating large amounts of categories with just a single API call. When using the bulk `sourceId` endpoint, the categories are identified by `sourceId`, `source`. If a category doesn't already exist, it will be created. If it does exist, the category will be updated.

📄️ Bulk Cluster Options by lookupKey

The bulk endpoints offer an efficient way of importing/updating large amounts of cluster options with just a single API call. The same lookup key is used for the options as for the cluster. When using the bulk `id` endpoint, the options are identified by Propeller option `id`. If an option with such `id` doesn't already exist, it will be created. If it does exist, the option will be updated.

📄️ Bulk Cluster Products by sourceId

The bulk endpoints offer an efficient way of importing/updating large amounts of cluster products with just a single API call. The same lookup key is used for the products as for the cluster. When using the bulk `id` endpoint, the products are identified by Propeller product `id`. If a product with such `id` doesn't already exist, it will be created. If it does exist, the product will be updated.

📄️ Bulk Clusters by Id

The bulk endpoints offer an efficient way of importing/updating large amounts of clusters with just a single API call. When using the bulk `id` endpoint, the clusters are identified by Propeller cluster `id`. If a cluster with such `id` doesn't already exist, it will be created. If it does exist, the cluster will be updated.

📄️ Bulk Clusters by sourceId

The bulk endpoints offer an efficient way of importing/updating large amounts of clusters with just a single API call. When using the bulk `sourceId` endpoint, the clusters are identified by `sourceId` and `source`. If a cluster doesn't already exist, it will be created. If it does exist, the cluster will be updated.

📄️ Bulk Companies by Id

The bulk endpoints offer an efficient way of importing/updating large amounts of companies with just a single API call. When using the bulk `id` endpoint, the companies are identified by `id`. If a company with such `id` doesn't already exist, it will be created. If it does exist, the company found will be updated.

📄️ Bulk Companies by source id

The bulk endpoints offer an efficient way of importing/updating large amounts of companies with just a single API call. When using the bulk `sourceId` endpoint, the companies are identified by `sourceId` and `source`. If a company doesn't already exist, it will be created. If it does exist, the company found will be updated.

📄️ Company Bulk Addresses

Use this endpoint to create multiple company addresses with a single API request. If an address with the code provided is found, it will be updated, otherwise a new address will be created. If the code is not provided, a new address will be created. When a new address is successfully created, the response will include the address `id`.

📄️ Bulk Contacts by Id

The bulk endpoints offer an efficient way of importing/updating large amounts of contacts with just a single API call. When using the bulk `id` endpoint, the contacts are identified by `id`. If a contact doesn't already exist, it will be created. If it does exist, the contact found will be updated.

📄️ Bulk Contacts by source id

The bulk endpoints offer an efficient way of importing/updating large amounts of contacts with just a single API call. When using the bulk `sourceId` endpoint, the contacts are identified by `sourceId` and `source`. If a contact doesn't already exist, it will be created. If it does exist, the contact found will be updated.

🗃️ bulk-cost-prices

6 items

📄️ Customer Bulk Addresses

Use this endpoint to create multiple customer addresses with a single API request. If an address with the code provided is found, it will be updated, otherwise a new address will be created. If the code is not provided, a new address will be created. When a new address is successfully created, the response will include the address `id`.

📄️ Bulk Customers by Id

The bulk endpoints offer an efficient way of importing/updating large amounts of customers with just a single API call. When using the bulk `id` endpoint, the customers are identified by `id`. If a customer doesn't already exist, it will be created. If it does exist, the customer found will be updated.

📄️ Bulk Customers by source id

The bulk endpoints offer an efficient way of importing/updating large amounts of customers with just a single API call. When using the bulk `sourceId` endpoint, the customers are identified by `sourceId` and `source`. If a customer doesn't already exist, it will be created. If it does exist, the customer found will be updated.

📄️ Bulk Inventory by lookup key / inventory type

The bulk inventory endpoint is used to create or update inventory records. The products can be identified based on one of their lookup keys. The inventory record type can be either `local` or `supplier`.

📄️ Bulk Local Inventory (deprecated)

The bulk local inventory endpoint is used to create or update inventory records.

🗃️ bulk-prices

6 items

📄️ Bulk Product by Id

The bulk endpoints offer an efficient way of importing/updating large amounts of products with just a single API call. When using the bulk `id` endpoint, the products are identified by Propeller product `id`. If a product with such `id` doesn't already exist, it will be created. If it does exist, the product will be updated.

📄️ Bulk Product by source id

The bulk endpoints offer an efficient way of importing/updating large amounts of products with just a single API call. When using the bulk `sourceId` endpoint, the products are identified by `sourceId` and `source`. If a product doesn't already exist, it will be created. If it does exist, the product found will be updated.

📄️ Bulk Supplier Inventory (deprecated)

The bulk supplier inventory endpoint is used to create or update inventory records.

📄️ Bulk User Addresses

Use this endpoint to create multiple user addresses with a single API request. If an address with the code provided is found, it will be updated, otherwise a new address will be created. If the code is not provided, a new address will be created. When a new address is successfully created, the response will include the address `id`.

📄️ Bulk Usergroup Addresses

Use this endpoint to create multiple usergroup addresses with a single API request. If an address with the code provided is found, it will be updated, otherwise a new address will be created. If the code is not provided, a new address will be created. When a new address is successfully created, the response will include the address `id`.

📄️ Bulk Usergroups by Id

The bulk endpoints offer an efficient way of importing/updating large amounts of usergroups with just a single API call. When using the bulk `id` endpoint, the usergroups are identified by `id`. If a usergroup with such `id` doesn't already exist, it will be created. If it does exist, the usergroup found will be updated.

📄️ Bulk Usergroups by source id

The bulk endpoints offer an efficient way of importing/updating large amounts of usergroups with just a single API call. When using the bulk `sourceId` endpoint, the usergroups are identified by `sourceId` and, `source`. If a usergroup doesn't already exist, it will be created. If it does exist, the usergroup found will be updated.

📄️ Bulk Users by Id

The bulk endpoints offer an efficient way of importing/updating large amounts of user with just a single API call. When using the bulk `id` endpoint, the products are identified by `id`. If a user doesn't already exist, it will be created. If it does exist, the user found will be updated.

📄️ Bulk Users by source id

The bulk endpoints offer an efficient way of importing/updating large amounts of user with just a single API call. When using the bulk `sourceId` endpoint, the users are identified by `sourceId` and `source`. If a user doesn't already exist, it will be created. If it does exist, the user found will be updated.

🗃️ bundles

9 items

🗃️ categories

10 items

📄️ Categories

🗃️ cluster-config

7 items

📄️ Cluster Config

Cluster Config

🗃️ clusters

21 items

📄️ Clusters

Clusters

🗃️ companies

15 items

📄️ Companies

Companies

🗃️ contacts

8 items

📄️ Contacts

Contacts

🗃️ core-concepts

8 items

🗃️ cost-prices

6 items

📄️ Create Category

Use this endpoint to create a single category. If a category is successfully created, the response will include the category `id`.

📄️ Create Cluster Config

Use this endpoint to create a cluster config. If a cluster config is successfully created, the response will include the cluster config `id`.

📄️ Create Cluster Option

Use this endpoint to create a single cluster option. If a cluster option is successfully created, the response will include the option `id`.

📄️ Create Cluster

Use this endpoint to create a single cluster. If a cluster is successfully created, the response will include the cluster `id`.

📄️ Create Company Address

Use this endpoint to create an address for a company. If the address is successfully created, the response will include the address `id`.

📄️ Create Company

Use this endpoint to create a single company. If a company is successfully created, the response will include the usergroup `id`.

📄️ Create Contact

Use this endpoint to create a single contact. If a contact is successfully created, the response will include the user `id`.

📄️ Create Customer Address

Use this endpoint to create an address for a customer. If the address is successfully created, the response will include the address `id`.

📄️ Create Customer

Use this endpoint to create a single customer. If a customer is successfully created, the response will include the user `id`.

📄️ Create Option Product

> The same endpoints for option products are used as the cluster products, with a difference that option id is used in lookupValue variable instead if cluster id

📄️ Create Product Local Inventory

This endpoint allows creating local inventory data for a product based on a lookup key.

📄️ Create Product Supplier Inventory

This endpoint allows creating supplier inventory data for a product based on a lookup key.

📄️ Create Product

Use this endpoint to create a single product. If a product is successfully created, the response will include the product`id`.

📄️ Create User Address

Use this endpoint to create an address for a user. If the address is successfully created, the response will include the address `id`.

📄️ Create User

Use this endpoint to create a single user. If a user is successfully created, the response will include the user `id`.

📄️ Create Usergroup Address

Use this endpoint to create an address for a usergroup. If the address is successfully created, the response will include the address `id`.

📄️ Create Usergroup

Use this endpoint to create a single usergroup. If a usergroup is successfully created, the response will include the usergroup `id`.

🗃️ customers

15 items

📄️ Customers

Customers

📄️ Delete Category by lookup key

Use this endpoint to delete category by lookup key.

📄️ Delete Category translation by lookup key

Use this endpoint to delete category translation by lookup key and the language for which the translation needs to be deleted.

📄️ Delete Cluster by lookup key

Use this endpoint to delete cluster by lookup key.

📄️ Delete Company Address

Use this endpoint to delete a company address. The address is identified by `id`.

📄️ Delete Company by lookup key

Delete a company by a specific lookupKey / lookupId combination. A deleted company will be moved to the Propeller Recycle bin. This means the deleted company can be restored, however, only via the Propeller backoffice.

📄️ Delete Contact by lookup key

Delete a `contact` by a specific lookupKey / lookupId combination. A deleted `contact` will be moved to the Propeller Recycle bin. This means the deleted contact can be restored, however, only via the Propeller backoffice.

📄️ Delete Customer Address

Use this endpoint to delete a customer address. The address is identified by `id`.

📄️ Delete Customer by lookup key

Delete a `customer` by a specific lookupKey / lookupId combination. A deleted `customer` will be moved to the Propeller Recycle bin. This means the deleted customer can be restored, however, only via the Propeller backoffice.

📄️ Delete Inventory by Id

This endpoint allows deleting inventory record by it's Propeller inventory id.

📄️ Delete Option by Cluster lookup key and Option Id

Use this endpoint to delete single cluster option by cluster lookup key and option id.

📄️ Delete Product by Cluster lookup key and Product Id

Use this endpoint to delete single cluster product details by cluster lookup key and product id.

📄️ Delete Product by lookup key

Use this endpoint to delete product by lookup key. If multiple products with the same lookup key exist, use additional filtering depending on the lookup key to uniquely identify the product (e.g. `source` and `language` for lookup key `source`).

📄️ Delete Product translation by lookup key

Use this endpoint to delete product translation by lookup key and the language for which the translation needs to be deleted.

📄️ Delete User Address

Use this endpoint to delete a user's address. The address is identified by `id`.

📄️ Delete User by lookup key

Delete a `user` by a specific lookupKey / lookupId combination. A deleted `user` will be moved to the Propeller Recycle bin. This means the deleted user can be restored, however, only via the Propeller backoffice.

📄️ Delete Usergroup by lookup key

Delete a usergroup by a specific lookupKey / lookupId combination. A deleted usergroup will be moved to the Propeller Recycle bin. This means the deleted usergroup can be restored, however, only via the Propeller backoffice.

🗃️ discounts

7 items

🗃️ favoritelists

10 items

📄️ Get Access Token

Use this endpoint to retrieve an access token for accessing the REST APIs.

📄️ Get Addresses by type

Use this endpoint to retrieve a list of all company addresses. Addresses can be filtered by type.

📄️ Get Category by lookup key

Use this endpoint to retrieve category details by lookup key.

📄️ Get Cluster by lookup key

Use this endpoint to retrieve cluster details by lookup key.

📄️ Get Cluster Config by lookup key

Use this endpoint to retrieve cluster config details by lookup key.

📄️ Get Company Address by Id

Use this endpoint to retrieve details for a company address. The address is identified by `id`.

📄️ Get Company by lookup key

Use this endpoint to retrieve company details by lookup key.

📄️ Get Contact by lookup key

Use this endpoint to retrieve contact details by lookup key.

📄️ Get Customer Address by Id

Use this endpoint to retrieve details for a customer address. The address is identified by `id`.

📄️ Get Customer Addresses by type

Use this endpoint to retrieve a list of all customer addresses. Addresses can be filtered by type.

📄️ Get Customer by lookup key

Use this endpoint to retrieve customer details by lookup key.

📄️ Get Inventory by Id

This endpoint is used to get an inventory data via it's unique inventory record Id.

📄️ Get Option by Cluster lookup key and Option Id

Use this endpoint to get details of single cluster option by cluster lookup key and option id.

📄️ Get Options by Cluster lookup key

Use this endpoint to retrieve cluster options by cluster lookup key.

📄️ Get Product by Cluster lookup key and Product Id

Use this endpoint to retrieve single cluster product details by cluster lookup key and product id.

📄️ Get Product by lookup key

Use this endpoint to retrieve product details by lookup key. If multiple products with the same lookup key exist, use additional filtering depending on the lookup key to uniquely identify the product (e.g. `source` and `language` for lookup key `source`).