# Zylvie

High-converting cart software for solopreneurs to sell digital products and subscriptions.

- **Category:** ecommerce
- **Auth:** API_KEY
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `ZYLVIE`
- **Version:** 20260211_00

## Tools

### Create Product

**Slug:** `ZYLVIE_CREATE_PRODUCT`

Tool to create a new product. Use when you need to add a product with detailed custom options in Zylvie platform.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The vanity URL for your product. Must be unique and contain alphanumeric, underscore, hyphen, or dot characters only. |
| `tags` | array | No | List of tags to apply to this product. New tags will be created automatically. |
| `price` | string | Yes | The base price of your product. |
| `title` | string | Yes | The title of your product. |
| `display` | string ("featured" | "listed" | "unlisted" | "unpublished") | Yes | The display setting for your product. |
| `summary` | string | No | The summary for your product, in HTML format. |
| `currency` | string | Yes | The lower-cased 3-letter ISO currency code for your product. |
| `interval` | string ("day" | "week" | "month" | "year") | No | The interval for subscription charging. Required if pricing_model is 'subscription'. |
| `subtitle` | string | No | The subtitle of your product, which appears below the title. |
| `categories` | array | No | List of categories under which to put this product. New categories will be created automatically. |
| `description` | string | No | The description for your product, in HTML format. |
| `productfiles` | array | No | List of URLs of files for this product. |
| `shipping_fee` | string | No | The shipping fee for the product. |
| `pricing_model` | string ("one-time" | "subscription" | "delayed") | Yes | The pricing model for your product. |
| `productimages` | array | No | List of URLs of images for this product. |
| `shipping_type` | string ("flat" | "per_quantity") | No | The shipping fee type for your product. |
| `interval_count` | integer | No | How often to charge based on the interval. Required if pricing_model is 'subscription'. |
| `trial_period_days` | integer | No | Number of days of free trial before the subscriber is charged. |
| `collect_address_and_phone` | boolean | No | Whether to collect buyer's address and phone number at checkout. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Authenticating User

**Slug:** `ZYLVIE_GET_AUTHENTICATING_USER`

Tool to retrieve information about the currently authenticated user. Use when you have a valid Bearer token and need to fetch the authenticated user's profile.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Subscribe Webhook

**Slug:** `ZYLVIE_SUBSCRIBE_WEBHOOK`

Tool to subscribe to a webhook event by creating a workflow object. Use when you need to set up webhook notifications for sale, lead, affiliate, subscription, or cancel events. If a workflow with the same webhook URL already exists, returns the pre-existing workflow object.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trigger` | string ("sale" | "lead" | "affiliate" | "subscription" | "cancel") | Yes | The trigger event type: sale, lead, affiliate, subscription, or cancel. |
| `webhook_url` | string | Yes | The webhook URL for which to create a workflow. If a workflow with this URL already exists, the existing workflow is returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unsubscribe Webhook

**Slug:** `ZYLVIE_UNSUBSCRIBE_WEBHOOK`

Tool to unsubscribe from a webhook by deleting the workflow object associated with the specified webhook URL. Use after confirming the webhook URL to remove.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_url` | string | Yes | The webhook URL for the workflow you intend to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |