PHP SDK - v3 vs Date-versioned

,

Hello All,

We’ve noticed that there is a new PHP SDK available for the date-versioned API - GitHub - HubSpot/hubspot-sdk-php · GitHub compared to the previous v3 one - GitHub - HubSpot/hubspot-api-php: HubSpot API PHP Client Libraries for V3 version of the API · GitHub

We currently use the previous v3 version in our codebase and are just looking to confirm whether moving over to the date-versioned SDK will help future proof us against potential future deprecations coming in to v3 or v4 endpoints, as well as the OAuth1 changes I think I’ve saw if someone could help?

Hi @TomC86 and welcome, we are delighted to have you here!

Thanks for posting on the HubSpot Community!

To start with, I’d like to share these resources that might help:

Now, let’s consult our Top Experts: Hi @Anton, @SteveHTM and @zach_threadint do you have any insights to help @TomC86, please?

Thanks so much and have a wonderful day!
Bérangère

Hi @TomC86 :waving_hand:

Based on the official documentation, it’s not particularly clear whether or when to make this transition from the semantically versioned SDK to the date-based versioned one. However, given they’ve created a new GitHub repo for access to the date-based API versions, I’d guess making the transition is a good move (and likely will be required as they sunset the semantic API versions).

I hope this helps. Please let me know if you have any follow-up questions.

Hi @zach_threadint and thanks so much for your help! :orange_heart:

Yes @TomC86, I can confirm that moving to the date-versioned PHP SDK is definitely a great choice for staying future-ready.

This migration not only aligns you with the new versioning model, but also, together with the OAuth migration, ensures you’re set up well ahead of the upcoming changes.

I hope this helps!

Have a lovely day!
Bérangère

This post was created with the assistance of AI tools

Many thanks guys!
I have some time dedicated now to our HS integration stuff to bring us back up to date so I will start here.

Thank you both! Beginning discovery work now on the upgrade!

Can I just confirm whether there are any immediate plans for sunsetting of the v3 endpoints e.g. anything on ‘api.hubapi.com/crm/v3/’? I can see HubSpot Projects v2025.1 being deprecated next month and was worried I might not have as much time as I thought.

Hi @TomC86, my pleasure, happy to help! :hugs:

To answer your questions, CRM v3 APIs do not have an announced sunset date yet.

This documentation might be of interest: Sunsetted and deprecated APIs - HubSpot docs

And regarding Projects v2025.1, that deprecation is August 1, 2026. So you have about a month remaining for that.

I hope it helps!
Bérangère