Skio - Kodif

Skio

Skio simplifies subscriptions. With KODIF, you can fetch subscription details, edit billing intervals/dates, cancel a whole subscription or a single product, and look up users by email or ID.

Integration Actions

Skio - Cancel a Product in a Subscription

Cancel a Product in a Subscription using Skio. Requires subscription_line_id. Returns results based on the executed action.

See an example

  1. If the customer has not provided an email address earlier in the conversation, ask them to provide the email address
  2. Use the tool @Skio – Get Storefront User by Email with the customer’s provided email
  3. Use the tool @Skio – Get Subscription based on User ID with the retrieved skio_user_id to get a list of subscriptions for the user.
  4. Ask the user to select the subscription they want to review
  5. run the tool @Skio – Get Subscription Details for its skio_subscription_id.
  6. Provide the subscription details to the user and ask them to confirm which product they want to cancel in the subscription.
  7. Run the tool @Skio – Cancel a Product in a Subscription where the subscription_line_id is the selected ID of the product the user wants to cancel.
Skio - Cancel Subscription

Cancels an active Skio subscription and optionally sends a notification email to the customer.

This integration cancels an active subscription in Skio’s subscription management platform. When you use this tool, it immediately stops the recurring billing for the specified subscription. You can choose whether to automatically send a cancellation confirmation email to the customer, making it easy to keep subscribers informed about their account changes.

Parameters
Output

Returns a GraphQL response object containing the cancellation status. The main field is ok within the cancelSubscription object, which returns true when the subscription was successfully canceled and false if there was an issue with the cancellation.

Example Output:

{
  "data": {
    "cancelSubscription": {
      "ok": true
    }
  }
}

Read Less

Skio - Edit Subscription Interval

Edit Subscription Interval using Skio. Requires subscription_id and billing_interval and next_billing_date and quick_action_metadata and billing_interval_count and prepaid_delivery_interval and prepaid_delivery_interval_count. Returns results based on the executed action.

Read Less

Skio - Get Storefront User by Email

Looks up a Skio subscription customer using their email address to access their account details and subscription information.

This integration searches Skio’s subscription platform for a customer that matches the email you provide. It’s essential for subscription support teams who need to quickly access customer account details, manage subscriptions, or troubleshoot subscription-related issues. The tool returns the customer’s profile information including their unique Skio user ID, which can then be used with other Skio tools to manage their subscriptions.

Parameters
Output

Returns a Skio customer record with key details including skio_user_id (unique Skio identifier), email, firstName, lastName, phoneNumber, platformId (Shopify customer ID), siteId, createdAt, updatedAt, and shopifyTags. If no customer is found, returns “no users found”.

Example Output:

{
  "data": {
    "StorefrontUsers": [{
      "email": "sarah.johnson@example.com",
      "siteId": "18b84a41-b80b-49bb-8f46-68077fe49095",
      "lastName": "Johnson",
      "createdAt": "2025-12-26T12:28:21.444994+00:00",
      "firstName": "Sarah",
      "updatedAt": "2026-02-24T15:14:57.146843+00:00",
      "platformId": "gid://shopify/Customer/8759539826947",
      "phoneNumber": "+1-555-0123",
      "shopifyTags": ["vip", "subscription"],
      "skio_user_id": "b569c4c1-d8ca-42d8-8736-1cb3c287515a"
    }]
  }
}

Read Less

Skio - Get Subscription based on User ID

Retrieves all active subscriptions linked to a specific Skio storefront user ID to help customer service teams quickly view subscription details.

Parameters
Output

Returns a data object containing an array of Subscriptions. Each subscription includes skio_subscription_id (the unique subscription identifier), status (subscription state like ACTIVE), nextBillingDate (when the next payment is due), siteId (the store identifier), and cancelledAt (null for active subscriptions).

Example Output:

{
  "data": {
    "Subscriptions": [
      {
        "siteId": "2f8e94a3-c5b7-4d9e-8f1a-6b3c789def45",
        "status": "ACTIVE",
        "cancelledAt": null,
        "nextBillingDate": "2026-05-15T14:22:18.925+00:00",
        "skio_subscription_id": "1a2b3c4d-5e6f-7g8h-9i0j-k1l2m3n4o5p6"
      }
    ]
  }
}

Read Less

Skio - Get Subscription Details

Retrieves detailed information for a single Skio subscription, including billing schedule and product details.

Parameters
Output

Returns an array of subscription line items, each containing product details, billing information, and quantities. Key fields include sku, title, quantity, productVariantId, subscription_line_id, nextBillingDate, interval (DAY or MONTH), and intervalCount (how many intervals between billings).

Example Output:

[
  {
    "sku": "WLN-450-200D",
    "title": "Premium Wellness Kit | 4 Month Supply",
    "interval": "MONTH",
    "quantity": 2,
    "description": null,
    "intervalCount": 4,
    "nextBillingDate": "2026-03-15T10:30:25.123+00:00",
    "productVariantId": "b8e9f2a1-c4d7-4e8b-a9f2-d5c8b7e6a3f1",
    "subscription_line_id": "f3e8d9c2-b7a6-4f1e-8d9c-a2b5e8f1d4c7"
  }
]

Read Less

Skio - Set New Billing Date for a Subscription

Set New Billing Date for a Subscription using Skio. Requires nextBillingDate and skio_subscription_id. Returns the updated record with the applied changes.

Output

Returns a confirmation object indicating whether the billing date update was successful. The response contains a nested data object with updateNextBillingDate containing an ok boolean field that shows true when the update succeeds.

Example Output:

{
  "data": {
    "updateNextBillingDate": {
      "ok": true
    }
  }
}
Skio - Swap Products

Swaps a product in an existing Skio subscription by replacing one product variant with another.

Parameters
Output

Returns a confirmation object indicating whether the product swap was successful. The response contains a single field ok which is a boolean value that confirms if the operation completed successfully.

Example Output:

{
  "data": {
    "swapSubscriptionProductVariants": {
      "ok": true
    }
  }
}

Integration Configuration

Getting API Credentials

For information on getting the appropriate Integration credentials, visit the Skio site directly.