The Java SDK for social media posting
Schedule and publish to all 11 platforms from Java 11+. Built on java.net.http with Jackson as the only dependency, a fluent builder client, and a typed exception hierarchy.
Schedule your first post
1import com.omnisocials.OmniSocials;2import com.omnisocials.Params;3import com.fasterxml.jackson.databind.JsonNode;4import org.springframework.web.bind.annotation.*;5import java.util.List;67@RestController8public class LaunchController {910private final OmniSocials client = OmniSocials.fromEnv();1112@PostMapping("/launch")13public JsonNode launch(@RequestBody String content) {14return client.posts().create(Params.builder()15.put("content", content)16.put("channels", List.of("instagram", "linkedin", "x"))17.put("scheduled_at", "2026-07-21T09:00:00Z")18.build());19}20}
Built the way Java developers expect
Built on the JDK HttpClient with jackson-databind for JSON. Drops into Spring Boot, Quarkus or plain Java without a framework opinion.
OmniSocials.fromEnv() or a builder for explicit config, Params.builder() for request bodies, JsonNode responses you can walk or map.
Exponential backoff with jitter on rate limits, server errors and network failures. Honors Retry-After, never retries non-idempotent requests.
Stripe-style signature verification with constant-time comparison, so publish and engagement events reach your app safely.
Posts, media uploads, folders, accounts, analytics, best times, the social inbox and webhooks. Every v1 endpoint, one client.
The whole API, not a subset
The Java SDK covers every v1 endpoint, the same surface as the REST API.
Create, schedule, update and publish posts, stories and reels across all 11 platforms, including X threads and platform-specific options.
Upload images, video and PDFs from files, URLs or base64, up to 1GB via presigned uploads, with automatic compatibility checks per platform.
Pull per-post and per-account metrics, workspace overviews and best times to post, ready for your own dashboards.
Manage the social inbox from code: list DM, comment and mention conversations, pull full message threads, mark them read and send replies.
Subscribe to publish, failure and engagement events with signed payloads and a rotate-secret endpoint.
List connected accounts and organize content into folders, so your integration mirrors how the team works.
Search and validate taggable locations for platforms that support them.
Start building with Java today
One plan, every endpoint, all 11 platforms.
Everything you need to start:
- Unlimited scheduled posts
- Unified social inbox
- Basic analytics
- Schedule posts, stories & reels
- Invite colleagues and or clients to collaborate
- Public API & MCP server access
- 24/5 Support
Need more accounts or team features? View all plans →
Frequently asked questions
Can't find your question answered?
Reach out to support