How do I install the OmniSocials Go SDK?

Run go get github.com/OmniSocials/omnisocials-go. It needs Go 1.26 or later. Then set OMNISOCIALS_API_KEY to an API key from Settings, API in the OmniSocials app.

How do I post to Instagram, LinkedIn or X with Go?

Connect the accounts once in the OmniSocials app. Then create the client with omnisocials.NewClient() and call client.Posts.Create() with the content, the channels and the time to post. Leave out the time and the post stays a draft for your team.

Does the Go SDK support async code?

Calls block and take a context.Context first, so you control timeouts and cancellation. Run them in goroutines when you need work in parallel.

How do I verify OmniSocials webhooks in Go?

Pass the raw request body, the X-OmniSocials-Signature header and your webhook secret to VerifyWebhookSignature(). It checks the HMAC-SHA256 signature with a constant-time compare, rejects deliveries older than 5 minutes and returns the parsed event.

What happens when my Go code hits the rate limit?

The API allows 100 requests per minute per key. The SDK retries 429 responses, server errors and dropped connections twice by default and waits for Retry-After. If the limit still holds, it returns a *RateLimitError with the time to wait.

Do I need my own developer app for each platform?

No. You connect each account once in the OmniSocials app with the platform's own sign-in (Telegram: press Start in the OmniSocials bot; Discord: Continue with Discord, or paste a webhook URL). After that, every API key of the workspace can post to it. The SDKs and the API do not connect accounts themselves.

Is there a sandbox or test mode?

No, there are no test keys. Leave out scheduled_at and a post stays a draft, so you can build against a real workspace without publishing. Many teams also keep a separate workspace with test accounts.

The SDKs are free and open source. They need an API key, which comes with every OmniSocials plan: $10 per seat per month billed annually, or $12 billed monthly. You can try it for 14 days first.

Go SDK

Social media SDK
for Go

Post, schedule, reply and report on 13 platforms from Go, with typed structs and context-first calls.

Get API key Read the docs

app.omnisocials.com/calendar

Released

2

Home

Create Post

Calendar

Posts

Analytics

Social Inbox

2

Automations

Approvals

1

Library

Latest updateDiscord channels

#announcements

OmniSocialsAPP924

1/3

JJens

Today

Week 43, 2026

WeekMonth

Mon

19

Tue

20

Wed

21

Thu

22

Fri

23

Sat

24

Sun

25

Posted

6:03 PM

A priority field cannot tell you whether...

Posted

9:00 AM

This is Beamer working for you... or not...

Scheduled

8:10 PM

Jira just got personal.

Draft

10:00 AM

We’ve put together a set of Jira how-to ...

In approval

10:00 AM

“Ready to configure” is a strange status...

Scheduled

9:00 AM

A roadmap you share with stakeholders an...

main.go~/released

1package main

3import (
  "context"
  "fmt"

  omnisocials "github.com/OmniSocials/omnisocials-go"
8)

10func main() {
  client, err := omnisocials.NewClient() // OMNISOCIALS_API_KEY
  if err != nil {
      panic(err)
  }
  post, err := client.Posts.Create(context.Background(),
      &omnisocials.PostCreateParams{
          Content:     "We’ve just added Jira Assets support…",
          Channels:    []string{"linkedin", "x", "facebook"},
          ScheduledAt: "2026-10-23T07:00:00Z",
      })
  if err != nil {
      panic(err)
  }
  fmt.Println(post.Data.ID, post.Data.Status)
25}

Terminalgo get github.com/OmniSocials/omnisocials-go

Webhooksyour-app.com/hooks

post.published10191 h ago200

post.approved10233 h ago200

Signed with HMAC-SHA256

main.go~/released

1package main

3import (
  "context"
  "fmt"

  omnisocials "github.com/OmniSocials/omnisocials-go"
8)

10func main() {
  client, err := omnisocials.NewClient() // OMNISOCIALS_API_KEY
  if err != nil {
      panic(err)
  }
  post, err := client.Posts.Create(context.Background(),
      &omnisocials.PostCreateParams{
          Content:     "We’ve just added Jira Assets support…",
          Channels:    []string{"linkedin", "x", "facebook"},
          ScheduledAt: "2026-10-23T07:00:00Z",
      })
  if err != nil {
      panic(err)
  }
  fmt.Println(post.Data.ID, post.Data.Status)
25}

Terminalgo get github.com/OmniSocials/omnisocials-go

Install in one lineFrom Go modules, for Go 1.26 or later. The source is on GitHub under MIT.go get github.com/OmniSocials/omnisocials-go

Stdlib onlyNo dependencies beyond net/http and crypto/hmac. Go 1.26+, one line in your go.mod and you are posting.net/http

Context-first, typed errorsEvery call takes a context for timeouts and cancellation. Typed error wrappers match cleanly with errors.As, including RateLimitError with RetryAfter.errors.As

Fits the Go stack you use

The same client in net/http and Gin. Each example schedules a post from your own code.

net/http~/released

1package main

3import (
  "encoding/json"
  "net/http"

  omnisocials "github.com/OmniSocials/omnisocials-go"
8)

10func main() {
  client, _ := omnisocials.NewClient() // reads OMNISOCIALS_API_KEY

  http.HandleFunc("/launch", func(w http.ResponseWriter, r *http.Request) {
      post, err := client.Posts.Create(r.Context(), &omnisocials.PostCreateParams{
          Content:     "Launch day is here",
          Channels:    []string{"instagram", "linkedin", "x"},
          ScheduledAt: "2026-11-03T09:00:00Z",
      })
      if err != nil {
          http.Error(w, err.Error(), http.StatusBadGateway)
          return
      }
      json.NewEncoder(w).Encode(post.Data)
  })

  http.ListenAndServe(":3000", nil)
27}

One client for the whole API

Posts, media, the inbox, analytics and webhooks sit on the same client, with the same names in every language.

app.omnisocials.com/posts

Released

2

Home

Create Post

Calendar

Posts

Analytics

Social Inbox

2

Automations

Approvals

1

Library

Latest updateDiscord channels

#announcements

OmniSocialsAPP924

1/3

JJens

Posted44Scheduled2Drafts1In approval1Rejected0Failed1

Platforms

Views

Likes

Comments

Search posts...

Post	Platforms	Views	Likes	Comments
We’ve just added Jira Assets support to boards in Jira. Oct 23, 2026, 9:00 AM		–	–	–	Edit
A roadmap you share with stakeholders and a changelog you publish to customers aren’t the same thing. Oct 25, 2026, 9:00 AM		–	–	–	Edit

media.go~/released

1video, err := client.Media.UploadFromURL(ctx,
2    &omnisocials.MediaUploadFromURLParams{
3        URL: "https://example.com/jira-assets.mp4",
4    })
5if err != nil {
6    return err
7}
8_, err = client.Posts.Create(ctx, &omnisocials.PostCreateParams{
9    Content:     "We’ve just added Jira Assets support…",
10    Channels:    []string{"instagram", "linkedin"},
11    MediaIDs:    []string{video.Data.ID},
12    ScheduledAt: "2026-10-23T07:00:00Z",
13})

Retries, errors and webhook checks built in

All eight follow one design. They retry what fails for a moment, raise a clear error for the rest and check every webhook signature.

errors.go~/released

1client, err := omnisocials.NewClient(
2    omnisocials.WithMaxRetries(5),
3    omnisocials.WithTimeout(60*time.Second),
4)
5if err != nil {
6    return err
7}
8_, err = client.Posts.Publish(ctx, "1019")
9var rl *omnisocials.RateLimitError
10if errors.As(err, &rl) {
11    log.Printf("rate limited, retry in %s", rl.RetryAfter)
12} else if errors.As(err, new(*omnisocials.ValidationError)) {
13    log.Println("rejected:", err)
14}

Requestsclient.posts.create()

1POST/v1/posts429 Too Many Requests
2POST/v1/posts503 Service Unavailable
3POST/v1/posts201 Created
Sending…

Automatic retriesRate limits, server errors and dropped connections retry with backoff. Retry-After is respected.2 retries by default

Errors you can catchOne class per failure: authentication, validation, not found, rate limit, server and connection.*RateLimitError

Timeouts you setSet the timeout, the retry count and the base URL per client. The defaults fit most apps.30 s per attempt

Webhook checksHMAC-SHA256 with a constant-time compare and a 5-minute replay window.VerifyWebhookSignature()

The Go package

Released with the other seven SDKs from one changelog. Need another language? See all eight on the SDK page.

All SDKs

Package: github.com/OmniSocials/omnisocials-go
Install
Version: 0.9.0Released Oct 5, 2026
Requires: Go 1.26 or later
Dependencies: Standard library only
Client: omnisocials.NewClient()
Responses: Typed structs
Webhooks: VerifyWebhookSignature()
Source: OmniSocials/omnisocials-go MIT license

Frequently
Asked Questions

Robert LigthartFounder of OmniSocials

Ask me a question

Still have a question?Ask Robert, the founder

Ask

Install it.Post today.

The SDKs, the API, the CLI and the MCP server come with every plan: $10 per seat per month, billed annually.

Get API key Read the docs

main.go

    post, err := client.Posts.Create(context.Background(),
        &omnisocials.PostCreateParams{
            Content:     "We’ve just added Jira Assets support…",
            Channels:    []string{"linkedin", "x", "facebook"},
            ScheduledAt: "2026-10-23T07:00:00Z",
        })
    if err != nil {
        panic(err)
    }
    fmt.Println(post.Data.ID, post.Data.Status)
}

~/releasedzsh
$go get github.com/OmniSocials/omnisocials-gogo: added github.com/OmniSocials/omnisocials-go v0.9.0$go run .1024 scheduled

Social media SDKfor Go

Fits the Go stack you useself.__wrap_n!=1&&self.__wrap_b("«Rkjeh5»",1)

One client for the whole APIself.__wrap_n!=1&&self.__wrap_b("«Rkkeh5»",1)

Retries, errors and webhook checks built inself.__wrap_n!=1&&self.__wrap_b("«Rkleh5»",1)

The Go packageself.__wrap_n!=1&&self.__wrap_b("«Rkmeh5»",1)

Frequently Asked Questionsself.__wrap_n!=1&&self.__wrap_b("«Rbneh5»",1)