Migration Guide

This guide covers two distinct migration scenarios: moving your brand from another social scheduling platform to Max Socials, and upgrading client integrations between Max Socials API versions.

Track 1. Migrating to Max Socials from another platform

Max Socials does not offer an automated import from Buffer, Hootsuite, or Sprout Social. Channel APIs do not expose scheduled post queues or brand configuration in a portable format, so each item below requires a brief manual step. For a single-brand setup, budget approximately 30 minutes.

Brand kit recreation

Your brand colors, logo, tone presets, and default hashtag sets must be re-created inside Max Socials. To speed this up, download our Brand Kit CSV template, fill in your values, and upload it on the Brand Kit page. The import populates name, hex colors, font preferences, and up to 30 saved hashtag groups. Profile photos and logo assets must be uploaded separately via the Assets library.

Scheduled posts

Scheduled posts cannot be transferred directly. The social channel APIs that Buffer, Hootsuite, and Sprout Social use do not provide read access to a client's outbound queue. You will need to re-create upcoming posts in Max Socials. We recommend:

1. Export your scheduled content from the outgoing platform as a CSV or PDF.
2. Use the Max Socials bulk composer to paste captions and assign publish dates in one session.
3. Reconnect your social channels under Settings → Connected Accounts before scheduling.

Historical analytics back-fill

Max Socials can import up to 90 days of historical performance data (impressions, engagements, reach) from a CSV export. This is optional but recommended if you want continuity in your analytics dashboards. Download the analytics import template, map your platform's export columns to ours, and upload it under Analytics → Import History. Data older than 90 days is accepted but will not appear in rolling-window trend charts.

Time estimate

A single-brand migration (brand kit, up to two weeks of scheduled content, and a 90-day analytics back-fill) takes roughly 30 minutes. Multi-brand migrations scale linearly; see the note at the bottom of this page if you are moving more than five brands at once.

Track 2. Migrating between Max Socials API versions

Max Socials follows a versioned API contract. Breaking changes are announced at least 30 days in advance via the Changelog and a direct email to all registered API clients.

v0 → v1 (v0 deprecated 2026-Q1, removed 2026-Q3)

The following changes were introduced in v1. Review each one and update your integration accordingly before the v0 removal date.

1. Endpoint rename: /v0/posts/schedule is now /v1/posts (POST). The path and HTTP verb both changed.
2. Response shape: The top-level data envelope was removed. v0 returned { data: { id, status } }; v1 returns { id, status } directly.
3. Authentication header: v0 accepted X-API-Key; v1 requires Authorization: Bearer <token>.
4. Date format: v0 accepted Unix timestamps; v1 requires ISO 8601 strings (2026-06-01T14:00:00Z).
5. Error codes: v0 used numeric codes (e.g. 4001); v1 uses human-readable slugs (e.g. invalid_schedule_time) aligned with RFC 7807 problem+json.

Compatibility helpers

Where the request and response shapes are structurally compatible, calls to /v0/* are transparently proxied to the equivalent v1 handler. For endpoints where the shape diverged (see items 1–5 above), the proxy returns an explicit 410 Gone with a migration_required error slug and a link to this page, rather than silently mangling the payload.

To verify which endpoints proxy cleanly and which require code changes, run your integration against the sandbox environment at https://sandbox.maxsocials.com before updating production credentials.

Pre-announcement policy

All breaking API changes are announced at least 30 days before the deprecation date. Notices are published to /docs/changelog and sent by email to the address on file for every API client. If you are not receiving deprecation emails, verify your notification preferences under Settings → Notifications.

Need help?

For platform migrations involving more than five brands, or for API migrations with complex custom integrations, our solutions team can provide a guided migration session. Contact us with the subject line “Migration Assist” and we will schedule a call within two business days.