<% user.full_name %>
<% util.level ? util.level.title : '' %>
Explorer Pioneer Apollo Viking Voyager Pathfinder Orion
Points
<% user.points ? user.points.toLocaleString() : 0 %>
Badges
<% util.badgeCount %>
Streaks
Congratulations You've <% util.newestBadge.isCurriculum ? 'completed' : 'earned' %> the
<% util.newestBadge.title %> <% util.newestBadge.isCurriculum ? 'curriculum' : 'badge' %>!
previous
next
Share to Social Media
Linked In Facebook
Status
<% util.level ? util.level.title : '' %>
<% util.level ? util.level.points : '' %>
<% util.nextLevel ? util.nextLevel.title : '' %>
<% util.nextLevel ? util.nextLevel.points : '' %>
Level up! <% util.levelPointsRemaining %> points to go
Level up! <% util.levelPointsRemaining %> points to go
Badges
Completed Hitchhikers Program Track Completed Content Track Completed Pages Track Completed Page Builder Track Completed Search Backend Track Completed Search Frontend Theme Track Completed Search UI React Track Completed Solution Templates and the Admin Console Track Completed Technical Skills Track Completed Platform Basics Track Completed Listings Track Completed Reviews Track Completed Industry Overview Track Completed Analytics Track Completed Industry Overview & Product Basics Track Completed Multi-Language Experiences Track Completed Fall '22 Release Highlights Track Completed Spring '23 Release Highlights Track Completed Chat Track Completed Summer '23 Release Highlights Track Completed Fall '23 Release Highlights Track
<% util.expandBadges ? 'Less' : 'More' %>
Playground Accounts
New +
No Playground Accounts
Create Playground +
View Profile
Log Out loading
Mission Complete! 🚀
Congratulations, you’ve completed your first module!

We hope you enjoy exploring the rest of the site. Please don’t forget to leave us feedback - we are constantly looking to improve. Happy Hitchhiking!
Home
Welcome to Hitchhikers! 👋
To learn more about the platform we encourage you to get started by completing the Hitchhikers Program Track and earning your first badge!
Start Here
Close notification
Guide
Migrating from v1 to v2
Arrow Back
Completed
Introduction
Introduction
completed
Completed 1
Step 1
Subscriptions Replaced with Services
completed
Completed 2
Step 2
Consolidated API Workflow
completed
Completed 3
Step 3
Detailed Agreement API Endpoint Changes
completed
home

Step 1: Subscriptions Replaced with Services

In the v1 API, a Location needed to be part of a Subscription before it could receive Yext services. This Subscription gave a Customer Yext’s offerings, such as Listings, beginning from the start date of the Subscription to its paid-through date. If a Customer canceled the Subscription, the offerings associated with the Subscription remained the same until the paid-through date. This lingering service complicated billing and made it difficult to add new services for an existing Customer.

In v2 of the API, Subscriptions are now replaced with Services. Services and Subscriptions share some similarities. In v1, specific Yext offerings were associated with a Subscription via an Offer id. In v2, the same offerings are associated with a Service with a sku ID.

However, there are a few key differences:

  1. A Service cannot be canceled until the minimum usage commitment has been met. For most Customers, this commitment is one month.
  2. A Customer stops receiving a Service the moment the Service is canceled (i.e., there is no paid-through date for a Service).
  3. There is no way to un-cancel a canceled Service. Instead, a new Service must be added to a Customer.
  4. These differences make it easier to manage the features a Customer is receiving, and they simplify operational and billing overhead on both sides.
Feedback
<% elem.innerText %>