Webhooks

Webhooks

List http transport configurations

get

List http transport configurations

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

pageNumberintegeroptional

Reference to a specific page in a result set.

pageSizeintegeroptional

The number of items per page in a result set.

sortBystringoptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumoptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Available options:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/httptransports HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Transport List response

{
  "items": [
    {
      "headers": [
        {
          "key": "text",
          "value": "text"
        }
      ],
      "name": "text",
      "password": "text",
      "securityType": "NONE",
      "token": "text",
      "httpTransportUid": "text",
      "url": "text",
      "username": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create new http transport configuration on a tenant

post

Add http transport configuration to tenant

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

all ofoptional

Transport Request Schema

Responses

application/json

objectoptional

Transport Response Schema

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/httptransports HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 169

{
  "headers": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "name": "text",
  "password": "text",
  "securityType": "NONE",
  "token": "text",
  "url": "text",
  "username": "text",
  "httpTransportUid": "text"
}

200

Transport response

{
  "headers": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "name": "text",
  "password": "text",
  "securityType": "NONE",
  "token": "text",
  "httpTransportUid": "text",
  "url": "text",
  "username": "text"
}

Get http transport configuration details

get

Get details for a http transport configuration.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

httpTransportUidstringrequired

Reference to a Http Transport.

Pattern: ^[A-Za-z0-9-_]+

Responses

application/json

objectoptional

Transport Response Schema

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/httptransports/{httpTransportUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Transport response

{
  "headers": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "name": "text",
  "password": "text",
  "securityType": "NONE",
  "token": "text",
  "httpTransportUid": "text",
  "url": "text",
  "username": "text"
}

Update tenant http transport configuration

put

Update http transport configuration for a tenant

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

httpTransportUidstringrequired

Reference to a Http Transport.

Pattern: ^[A-Za-z0-9-_]+

Body

Transport Request Schema

headersobject[]optional

Transport Header Schema

namestringrequired

passwordstringoptional

securityTypestring · enumrequiredAvailable options:

tokenstringoptional

urlstringrequired

usernamestringoptional

Responses

application/json

objectoptional

Transport Response Schema

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/httptransports/{httpTransportUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 143

{
  "headers": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "name": "text",
  "password": "text",
  "securityType": "NONE",
  "token": "text",
  "url": "text",
  "username": "text"
}

200

Transport response

{
  "headers": [
    {
      "key": "text",
      "value": "text"
    }
  ],
  "name": "text",
  "password": "text",
  "securityType": "NONE",
  "token": "text",
  "httpTransportUid": "text",
  "url": "text",
  "username": "text"
}

Delete a http transport configuration from a tenant

delete

Deletes a http transport configuration completely from a tenant.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

httpTransportUidstringrequired

Reference to a Http Transport.

Pattern: ^[A-Za-z0-9-_]+

Responses

delete

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/httptransports/{httpTransportUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No Content

List all webhooks

get

List all webhooks.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

pageNumberintegeroptional

Reference to a specific page in a result set.

pageSizeintegeroptional

The number of items per page in a result set.

sortBystringoptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumoptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Available options:

httpTransportUidstringoptional

Http Transport uid

Pattern: ^[A-Za-z0-9-_]+

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/webhooks HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "action": "PRODUCT_CREATE",
      "httpTransport": {
        "headers": [
          {
            "key": "text",
            "value": "text"
          }
        ],
        "name": "text",
        "password": "text",
        "securityType": "NONE",
        "token": "text",
        "httpTransportUid": "text",
        "url": "text",
        "username": "text"
      },
      "webhookUid": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

List all webhooks for a httpTransport

get

List all webhooks for a http transport.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

httpTransportUidstringrequired

Reference to a Http Transport.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

pageNumberintegeroptional

Reference to a specific page in a result set.

pageSizeintegeroptional

The number of items per page in a result set.

sortBystringoptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumoptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Available options:

Responses

application/json

objectoptional

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/httptransports/{httpTransportUid}/webhooks HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "action": "PRODUCT_CREATE",
      "httpTransport": {
        "headers": [
          {
            "key": "text",
            "value": "text"
          }
        ],
        "name": "text",
        "password": "text",
        "securityType": "NONE",
        "token": "text",
        "httpTransportUid": "text",
        "url": "text",
        "username": "text"
      },
      "webhookUid": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create new webhook on a httpTransport

post

Add webhook on a httpTransport

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

httpTransportUidstringrequired

Reference to a Http Transport.

Pattern: ^[A-Za-z0-9-_]+

Body

all ofoptional

Webhook Create Request Schema

Webhook Update Request Schema

Responses

application/json

objectoptional

Webhook Response

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/httptransports/{httpTransportUid}/webhooks HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "action": "PRODUCT_CREATE",
  "webhookUid": "text"
}

200

Example response

{
  "action": "PRODUCT_CREATE",
  "httpTransport": {
    "headers": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "name": "text",
    "password": "text",
    "securityType": "NONE",
    "token": "text",
    "httpTransportUid": "text",
    "url": "text",
    "username": "text"
  },
  "webhookUid": "text"
}

Get webhook details

get

Get details for a webhook.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

webhookUidstringrequired

Reference to a webhook

Pattern: ^[A-Za-z0-9-_]+

httpTransportUidstringrequired

Reference to a Http Transport.

Pattern: ^[A-Za-z0-9-_]+

Responses

application/json

objectoptional

Webhook Response

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/httptransports/{httpTransportUid}/webhooks/{webhookUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "action": "PRODUCT_CREATE",
  "httpTransport": {
    "headers": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "name": "text",
    "password": "text",
    "securityType": "NONE",
    "token": "text",
    "httpTransportUid": "text",
    "url": "text",
    "username": "text"
  },
  "webhookUid": "text"
}

Update tenant webhook

put

Update webhook for a tenant

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

webhookUidstringrequired

Reference to a webhook

Pattern: ^[A-Za-z0-9-_]+

httpTransportUidstringrequired

Reference to a Http Transport.

Pattern: ^[A-Za-z0-9-_]+

Body

Webhook Update Request Schema

actionstring · enumrequired

ENUM	Description
PRODUCT_CREATE	Create new product
PRODUCT_UPDATE	Update existing product
PRODUCT_DELETE	Product deleted
CUSTOMER_CREATE	Create new customer
CUSTOMER_UPDATE	Update existing customer
CUSTOMER_DELETE	Customer deleted
ORDER_SETTLED	New order. Order status is SETTLED
ORDER_RECEIPT_SETTLED	A receipt is SETTLED
ORDER_DELIVERED	Existing order. Order status DELIVERED
ORDER_HANDLING_STATE_CHANGED	An order handling has changed
TILL_CLOSED	Till has been counted and closed.
TILL_OPEN	Till has been opened.
PRICE_CREATE	Create new price.
PRICE_UPDATE	Update Price.
PRICE_DELETE	Price deleted
STOCK_CHANGE	Stock for a warehouseUid and productUid has changed.
PRODUCT_MEDIA_CHANGE	Product media has changed (create/update/delete).
PURCHASE_RECEIVED	Purchase order fully received

Available options:

Responses

application/json

objectoptional

Webhook Response

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/httptransports/{httpTransportUid}/webhooks/{webhookUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "action": "PRODUCT_CREATE"
}

200

Example response

{
  "action": "PRODUCT_CREATE",
  "httpTransport": {
    "headers": [
      {
        "key": "text",
        "value": "text"
      }
    ],
    "name": "text",
    "password": "text",
    "securityType": "NONE",
    "token": "text",
    "httpTransportUid": "text",
    "url": "text",
    "username": "text"
  },
  "webhookUid": "text"
}

Delete a webhook from a tenant

delete

Deletes a webhook from a tenant.

Required access: Tenant.Admin

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringrequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

webhookUidstringrequired

Reference to a webhook

Pattern: ^[A-Za-z0-9-_]+

httpTransportUidstringrequired

Reference to a Http Transport.

Pattern: ^[A-Za-z0-9-_]+

Responses

delete

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/httptransports/{httpTransportUid}/webhooks/{webhookUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No Content