# PHP SDK - v3 vs Date-versioned

**URL:** <https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115>\
**Category:** Develop, Build & Integrate\
**Tags:** php, sdk\
**Created:** [June 23, 2026, 10:21am UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115 "2026-06-23T10:21:22Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![TomC86](https://avatars.discourse-cdn.com/v4/letter/t/67e7ee/32.png) [@TomC86](https://community.hubspot.com/u/TomC86)\
**Post date:** [June 23, 2026, 10:21am UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115/1 "2026-06-23T10:21:22Z")

</div>

Hello All,

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

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?

---

<div class="post-metadata">

**Author:** ![Berangere](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/berangere/32/220784_2.png) [@Berangere](https://community.hubspot.com/u/Berangere)\
**Post date:** [June 23, 2026, 10:56am UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115/3 "2026-06-23T10:56:35Z")

</div>

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:

- [Migrate from the OAuth v1 API to the latest date-based versioned API - HubSpot docs](https://developers.hubspot.com/docs/api-reference/legacy/authentication/oauth-tokens/v1/migration-guide)
- [Legacy API reference - HubSpot docs](https://developers.hubspot.com/docs/api-reference/legacy/overview)
- [Developer platform and API versioning - HubSpot docs](https://developers.hubspot.com/docs/developer-tooling/platform/versioning)

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

---

<div class="post-metadata">

**Author:** ![zach\_threadint](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/zach_threadint/32/46318_2.png) [@zach\_threadint](https://community.hubspot.com/u/zach_threadint)\
**Post date:** [June 23, 2026, 9:38pm UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115/5 "2026-06-23T21:38:37Z")

</div>

Hi @TomC86 👋

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.

---

<div class="post-metadata">

**Author:** ![Berangere](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/berangere/32/220784_2.png) [@Berangere](https://community.hubspot.com/u/Berangere)\
**Post date:** [June 25, 2026, 12:02pm UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115/6 "2026-06-25T12:02:33Z")

</div>

Hi @zach_threadint and thanks so much for your help! 🧡

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_

---

<div class="post-metadata">

**Author:** ![TomC86](https://avatars.discourse-cdn.com/v4/letter/t/67e7ee/32.png) [@TomC86](https://community.hubspot.com/u/TomC86)\
**Post date:** [June 25, 2026, 12:13pm UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115/7 "2026-06-25T12:13:23Z")

</div>

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.

---

<div class="post-metadata">

**Author:** ![system](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/system/32/124_2.png) [@system](https://community.hubspot.com/u/system)\
**Post date:** [June 30, 2026, 11:56am UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115/8 "2026-06-30T11:56:59Z")

</div>

Automatically bumped on June 30, 2026, 11:56am UTC



---

<div class="post-metadata">

**Author:** ![TomC86](https://avatars.discourse-cdn.com/v4/letter/t/67e7ee/32.png) [@TomC86](https://community.hubspot.com/u/TomC86)\
**Post date:** [July 2, 2026, 3:13pm UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115/9 "2026-07-02T15:13:28Z")

</div>

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/](http://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.

---

<div class="post-metadata">

**Author:** ![Berangere](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/berangere/32/220784_2.png) [@Berangere](https://community.hubspot.com/u/Berangere)\
**Post date:** [July 2, 2026, 4:50pm UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115/10 "2026-07-02T16:50:22Z")

</div>

Hi @TomC86, my pleasure, happy to help! 🤗

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](https://developers.hubspot.com/docs/api-reference/deprecated-apis)

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

---

<div class="post-metadata">

**Author:** ![system](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/system/32/124_2.png) [@system](https://community.hubspot.com/u/system)\
**Post date:** [July 3, 2026, 7:00am UTC](https://community.hubspot.com/t/php-sdk-v3-vs-date-versioned/151115/11 "2026-07-03T07:00:30Z")

</div>

Automatically bumped on July 3, 2026, 7:00am UTC


