📅 Deprecation PolicyEach major change (deprecated section) includes a 6-month grace period before it takes effect.
- The date on the left shows when it was announced.
- The date in the yellow box shows when it will take effect.
⏰ This is a future deprecation notice
These changes will take effect on 15th April 2026. You have time to plan and update your integrations.
Deprecated
Business subscription management endpoints
You are affected if:- You are a provider
GET /v2/business/{business_id}/subscriptionPOST /v2/business/{business_id}/subscribePOST /v2/business/{business_id}/unsubscribe
GET /v2/business/{business_id}/plansPOST /v2/business/{business_id}/plans
⏰ This is a future deprecation notice
These changes will take effect on 15th January 2026. You have time to plan and update your integrations.
Deprecated
phone and keywords fields for users
The phone and keywords fields in all user-related endpoints are now deprecated and will be permanently removed.Image message sending via direct upload
Image messages can no longer be sent using direct file uploads (form-data) through:POST /v2/messagesYou are affected if:- You send messages via the message API on behalf of a business
- You upload image messages via direct file upload
Added
Media messaging support
You can now send and receive:- Audio
- Video
- Document
Not all channels support all media types.
| Channel | Image | Video | Audio | Document |
|---|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ | |
| ✅ | ✅ | ✅ | ❌ | |
| SMS | ❌ | ❌ | ❌ | ❌ |
| ✅ | ✅ | ✅ | ✅ |
GET /v2/conversationsGET /v2/conversations/{conversation_id}GET /v2/messagesPOST /v2/messagesEVENT message_createdEVENT message_updated
Added
Webhook configuration API
You can now configure webhooks directly from the API or in Settings > Integrations.Changed
Content-Type enforcement
AllPOST, PATCH, and PUT requests now require a valid Content-Type header. Default: application/json.Removed
category_gmb_id and presence analytics
category_gmb_idis removed. Usecategory_gmb_nameinstead.- Presence analytics endpoints are removed. Use Profile metrics and Profile keywords endpoints instead.
Deprecated
Review analytics V1 API
The following endpoints are deprecated:GET /v2/reviews/statsGET /v2/reviews/qualitative-evolutionGET /v2/reviews/quantitative-evolution
GET /v2/review_analytics/metrics instead.products in favor of features
We are introducing a more granular feature-based permission system across organizations, businesses, and users.Changed
Mappings for review analytics
/v2/reviews/stats→?metrics=average_rating,rating_distribution,reply_time,reviews_count/v2/reviews/quantitative-evolution→?dimensions={day|week|month|year}&metrics=reviews_count/v2/reviews/qualitative-evolution→?dimensions={day|week|month|year}&metrics=reviews_count,average_rating
New features field usage
Organization
- Use
org_featuresto get the active features - Use
featuresto list all available features
Business
- New field:
features - Searchable using
features__inandfeatures__notin
User
sidebar_products→sidebar_pages
Deprecated fields
has_google_postdisplay_google_postsidebar_products
Added
Store Code identification enabled
Use business codes instead of IDs in endpoints. Example:Use the
/c- prefix to denote a business code path.Removed
REPEATABLE_URL no longer supported
Replace with Place Action Links:GET /business/{business_id}/place_action_linksPOST /business/{business_id}/place_action_links
Changed
Nullable business address fields
Fields likeaddress, address_full, zipcode, city, lat, and long can return null.DELETE endpoint body parameters deprecated
force→ query param forDELETE /organizationforced_update→forceinDELETE /custom-field
forced_update renamed to force in PUT
In PUT /custom-field, parameter forced_update is now force.Security
Webhooks now signed
Webhook requests are signed.Security
Rate limiting enabled
Limit: 300 requests per minute per organization.Deprecated
Presence analytics endpoints
GET /v2/presence_analyticsGET /v2/presence_analytics/export
Removed
Google Posts insights
Google views and clicks data are no longer available.Facebook insights still available via
GET /v2/posts.Removed
Google Post endpoints removed
Deprecated in favor of unified/posts.Changed
category_gmb_id fields replaced
With category_gmb_name in:GET /v2/services/suggestionsGET /v2/business/{business_id}/servicesPOST /v2/business/{business_id}/free_form_servicesPOST /v2/business/{business_id}/structured_services
Deprecated
Categories endpoint
GET /v2/category/{category_id}→ replaced byGET /v2/categories/{category_id}
Changed
Category enhancements
with_namesfor translated nameswith_countriesfor available countries
Removed
Obsolete integration endpoints
GET /v2/business/{business_id}/integration_statusGET /v2/business/{business_id}/partner_urlsGET /v2/publisher_states/business_infoGET /v2/publisher_states/businesses_info
GET /v2/publisher_statestemplate_id removed from review booster
- Affects:
POST /v2/review_booster/send_invitation
Templates in use are not affected.
Added
Pagination support
Useper_page in:GET /v2/reviewsGET /v2/business/searchGET /v2/user/search
Changed
Sandbox API base URL
New:api.sandbox.partoo.coOld: sandbox.api.partoo.co (deprecated)Deprecated
Obsolete endpoints
GET /v2/GET street typesGET /v2/GET number supplements
Changed
Category endpoint updates
idis now an integergmb_idadded to response
Removed
Categories search endpoint
Use:GET /v2/categoriesDeprecated
API key authorization routes
POST /v2/authorizeGET /v2/authorize/listPOST /v2/authorize/revoke
POST /v2/connection/generate_tokenBusiness fields
clean_namevideosiretnews
Field
country now uses a standardized code format.