Skip to main content

API integration

Sync orders, inventory and indeliveries via API

Webhook

Receive real-time order updates

​
Supported data types

Orders

Customer transactions

Inventory

Stock levels & product data

Indeliveries

Incoming products

Returns

Order return details

​
API integration

​
Prerequisites

To integrate Centra with our platform, you need to have an API token within your Centra project.

​
Step-by-step integration guide

1

Create an API token in Centra

  1. From the left panel, navigate to System ⟩ API Tokens.
  2. Click Create integration API token in the top right corner.
  3. Give the token a description and set Integration name to Integration API, or create a new one (e.g. Dema).
  4. Set an expiry date.
  5. Set Restrictions based on your needs, or leave unchecked.
  6. Under Permissions, select the required read permissions. See the full list of permissions below.
  7. Click Save to generate the token and copy it along with your store endpoint (e.g. https://yourstore.centra.com/graphql).
2

Share credentials with Dema

Share your API token and endpoint with your Customer Success Manager.
For security reasons, send this information via a secure password sharing method.
Example
{
  "token": "exampletoken123456789",
  "endpoint": "https://examplestore.centra.com/graphql"
}
  • Allocation:read
  • AllocationRule:read
  • Attribute:read
  • Brand:read
  • Category:read
  • Collection:read
  • Display:read
  • Folder:read
  • Market:read
  • Market.comment:read
  • Order:read
  • Order.attributes:read
  • Order.billingAddress:read
  • Order.internalComment:read
  • Order.shippingAddress:read
  • PaymentHistory:read
  • Product:read
  • Product.attributes:read
  • ProductMedia:read
  • ProductMedia.attributes:read
  • ProductSize:read
  • ProductSize.stockTotals:read
  • ProductVariant:read
  • ProductVariant.stock:read
  • ProductVariant.stockTotals:read
  • PurchaseOrder:read
  • Return:read
  • Shipment:read
  • Store:read
  • StorePlugin:read
  • Voucher:read
  • Warehouse:read

​
Webhook

Setting up the webhook allows Dema to receive order data from Centra in real-time.

​
Prerequisites

To use Centra webhook with our platform, you need to setup a plugin with the necessary permissions within your Centra store.

​
Step-by-step webhook guide

1

Initial steps

For the webhook setup, a webhook URL and endpoint secret are required to securely access your Centra data.
  1. From the left panel, navigate to Stores management ⟩ Stores.
  2. Click the row (or the View link) for the Store you want to add the webhook to. The Store details will open to the right.
  3. Scroll down to the Plugins section and click the ”+ Add plugin method” button.
  4. Select “Active” from the Status dropdown.
  5. Enter a name for the plugin, preferably “Dema Webhook”, in the Plugin name field.
  6. Choose “Centra Webhook” from the Plugin dropdown. This will add some more fields to the form.
2

Configuring the webhook

  1. In the Webhook URL field, enter the following URL:
https://centra-webhook.dema.ai/DV-XXXXXXXXXXXXXXXXXXXX
where DV-XXXXXXXXXXXXXXXXXXXX is the unique ID provided by Dema for your store.
  1. Share the pre-generated Endpoint secret securely with Dema.
  2. From the Version dropdown, choose “Integration API”.
  3. Under Event triggers, choose “Yes” for Order, and “No” for others.
  4. Leave the default values for all other fields.
  5. Click on the Save button (top right) when you’re ready.

​
Troubleshooting and support

If you face any challenges during the integration process or have any questions about the setup, our support team is ready to assist you.

​
Additional resources

For further details on managing your Centra account and utilizing the API, refer to the Centra Documentation.