---
title: "Email subscription service endpoint"
method: POST
path: "/widgetsvc/emailsubscription/{widgetId}"
tags: ["WidgetService"]
---

# Email subscription service endpoint

`POST /widgetsvc/emailsubscription/{widgetId}`

## Path parameters

- `widgetId` integer, required

## Request body

- EmailSubscribeCriteria — Model for email subscription criteria
  - `emailAddress` string, nullable — Email addrwss
  - `firstName` string, nullable — Subscriber first name
  - `lastName` string, nullable — Subscriber last name

## Response `200`

OK

- WidgetSettingsResponse — Model for widget settings API response
  - `versionId` integer
  - `name` string, nullable
  - `url` string, nullable
  - `developerName` string, nullable
  - `widgetId` integer, nullable
  - `settingsName` string, nullable
  - `subscriptionLevel` integer
  - `apiCredentials` string, nullable
  - `applicationSettings` ApplicationSettings — Model defining application public settings
    - `defaultCurrency` string, nullable — Default currency code
    - `currencies` string[], nullable — Array of supported currencies
    - `defaultLanguage` string, nullable — Default language code
    - `languages` object, nullable — Array of supported languages
    - `defaultNationality` string, nullable — Default nationality code
    - `nationalities` object, nullable — Array of supported nationalities
    - `basketUrl` string, nullable — Basket page URL
  - `appId` integer, nullable
  - `embedCode` string, nullable
  - `styles` string[], nullable
  - `scripts` string[], nullable
  - `initialSettings` object, nullable
  - `templates` Template[], nullable
    - `id` integer
    - `orderIdx` integer
    - `name` string, nullable
    - `imageUrl` string, nullable
    - `settings` object, nullable
  - `categories` Category[], nullable
    - `id` integer
    - `name` string, nullable
    - `settings` Setting[], nullable
      - `id` string, nullable
      - `orderIdx` integer
      - `showIf` object, nullable
      - `type` string, nullable
      - `label` boolean
      - `name` string, nullable
      - `description` string, nullable
      - `placeholder` string, nullable
      - `pattern` string, nullable
      - `editName` string, nullable
      - `displayField` string, nullable
      - `value` unknown
      - `defaultValue` unknown
      - `maxLength` integer, nullable
      - `maxItems` integer, nullable
      - `minimumValue` number, double, nullable
      - `maximumValue` number, double, nullable
      - `stepValue` number, double, nullable
      - `imageType` string, nullable
      - `required` boolean
      - `advanced` unknown
      - `options` Option[], nullable
        - `value` string, nullable
        - `text` string, nullable
      - `objectSettings` Setting[], nullable
      - `arrayData` DataItem[], nullable
        - `rowId` integer
        - `rowData` object, nullable
      - `showMenu` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/travelify/apis/travelify-io-api.md) · [All operations](https://skmtc.dev/travelify/apis/travelify-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/travelify/travelify-io-api/revisions/b09ce3f0c6d5/schema)