Templates

Templates

List metadata transaction templates

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/metadata/templates

List metadata transaction templates

Header parameters

Accept-LanguagestringOptional

RFC 7231 language tags format (e.g., en-US, nl-NL) to use for returning localized names

Responses

200

List templates response

application/json

get

/metadata/templates

HTTPcURLJavaScriptPython

GET /v2/metadata/templates HTTP/1.1
Host: api.flowretail.com
Accept: */*

200

List templates response

{
  "items": [
    {
      "type": "SMS_PICKUP_NOTE",
      "name": "SMS pickup note",
      "template": "Your order {.orderNumber} is ready to be picked up in {.storeName}",
      "mimeType": "HTML",
      "fields": [
        {
          "name": ".orderNumber",
          "description": "The ordernumber on the order"
        }
      ]
    }
  ]
}

List transaction templates

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/templates

List transaction templates

Authorizations

authTokenaccessToken

AuthorizationstringRequired

Token received from the auth service

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.

sortDirectionstring · enumOptional

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

Possible values:

sortBystringOptional

Defines which field the resource list is sorted by.

templateTypestringOptional

Filter on Template Type

Responses

200

TransactionTemplatesResponse

application/json

get

/tenants/{tenantUid}/templates

HTTPcURLJavaScriptPython

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

200

TransactionTemplatesResponse

{
  "items": [
    {
      "type": "SMS_PICKUP_NOTE",
      "name": "SMS pickup note",
      "template": "Your order {.orderNumber} is ready to be picked up in {.storeName}",
      "subject": "text",
      "mimeType": "HTML",
      "templateUid": "text",
      "createdAt": "2025-12-16T00:14:19.885Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-12-16T00:14:19.885Z",
      "lastModifiedBy": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create transaction template

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/templates

Create transactio template

Authorizations

authTokenaccessToken

AuthorizationstringRequired

Token received from the auth service

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

Body

application/json

TransactionTemplateRequestSchema

typestringRequired

This must be a valid type from /metadata/templates

Example: SMS_PICKUP_NOTE

templatestringRequiredExample: Your order {.orderNumber} is ready to be picked up in {.storeName}

subjectstringOptional

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

Responses

201

TransactionTemplateResponse

application/json

post

/tenants/{tenantUid}/templates

HTTPcURLJavaScriptPython

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

{
  "type": "SMS_PICKUP_NOTE",
  "template": "Your order {.orderNumber} is ready to be picked up in {.storeName}",
  "subject": "text",
  "templateUid": "text"
}

201

TransactionTemplateResponse

{
  "type": "SMS_PICKUP_NOTE",
  "name": "SMS pickup note",
  "template": "Your order {.orderNumber} is ready to be picked up in {.storeName}",
  "subject": "text",
  "mimeType": "HTML",
  "templateUid": "text",
  "createdAt": "2025-12-16T00:14:19.885Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-12-16T00:14:19.885Z",
  "lastModifiedBy": "text"
}

Get transaction template by templateUid

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/templates/{templateUid}

Get transaction template by templateUid

Authorizations

authTokenaccessToken

AuthorizationstringRequired

Token received from the auth service

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

templateUidstringRequired

Reference to a template.

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

Responses

200

TransactionTemplateResponse

application/json

get

/tenants/{tenantUid}/templates/{templateUid}

HTTPcURLJavaScriptPython

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

200

TransactionTemplateResponse

{
  "type": "SMS_PICKUP_NOTE",
  "name": "SMS pickup note",
  "template": "Your order {.orderNumber} is ready to be picked up in {.storeName}",
  "subject": "text",
  "mimeType": "HTML",
  "templateUid": "text",
  "createdAt": "2025-12-16T00:14:19.885Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-12-16T00:14:19.885Z",
  "lastModifiedBy": "text"
}

Update transaction template by templateUid

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/templates/{templateUid}

Update transaction template by templateUid

Authorizations

authTokenaccessToken

AuthorizationstringRequired

Token received from the auth service

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

templateUidstringRequired

Reference to a template.

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

Body

application/json

templatestringRequiredExample: Your order {.orderNumber} is ready to be picked up in {.storeName}

subjectstringOptional

Responses

200

TransactionTemplateResponse

application/json

put

/tenants/{tenantUid}/templates/{templateUid}

HTTPcURLJavaScriptPython

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

{
  "template": "Your order {.orderNumber} is ready to be picked up in {.storeName}",
  "subject": "text"
}

200

TransactionTemplateResponse

{
  "type": "SMS_PICKUP_NOTE",
  "name": "SMS pickup note",
  "template": "Your order {.orderNumber} is ready to be picked up in {.storeName}",
  "subject": "text",
  "mimeType": "HTML",
  "templateUid": "text",
  "createdAt": "2025-12-16T00:14:19.885Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-12-16T00:14:19.885Z",
  "lastModifiedBy": "text"
}

Delete transaction template by templateUId

delete

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/templates/{templateUid}

Delete transaction template by templateUId

Authorizations

authTokenaccessToken

AuthorizationstringRequired

Token received from the auth service

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

templateUidstringRequired

Reference to a template.

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

Responses

200

OK

No content

404

Not Found

delete

/tenants/{tenantUid}/templates/{templateUid}

HTTPcURLJavaScriptPython

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

No content

Render transaction template preview

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/templates/{templateUid}/notifications-preview

Render transaction template preview

Authorizations

authTokenaccessToken

AuthorizationstringRequired

Token received from the auth service

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

templateUidstringRequired

Reference to a template.

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

Responses

200

OK

text/html

Responseobject

400

Bad Request

post

/tenants/{tenantUid}/templates/{templateUid}/notifications-preview

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/templates/{templateUid}/notifications-preview HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{}