Webhooks

Webhooks let another system react when Studio publishes something: post the link in a team chat, log it in a spreadsheet, or start an automation in a tool such as Zapier, Make or n8n.

What does a webhook send?#

When a post is published on a channel, Studio sends one POST request to each webhook that covers that channel. The body is JSON with the post's text, publish time, live address and channel.

Webhooks fire only for published posts. Scheduling, editing, deleting or a failed publish sends nothing.

How do I add a webhook?#

1. In Studio, open Settings › Webhooks and choose Add a webhook.
2. Enter a Name you will recognise.
3. Enter the URL that should receive the request. It must be a public HTTPS address; private and internal network addresses are refused.
4. Under Integrations, choose All integrations, or Specific integrations and pick the channels.
5. Choose Send Test to check your endpoint, then Save.

To change or remove a webhook, use Edit or Delete next to it in the list.

What does the payload look like?#

The body is a JSON array. A real delivery holds one object, for the published post:

[
  {
    "id": "cm6tcts4f0005qcwit25cis26",
    "content": "<p>Our new release is out.</p>",
    "publishDate": "2026-11-02T09:00:00.000Z",
    "releaseURL": "https://www.linkedin.com/feed/update/urn:li:share:7000000000000000000",
    "state": "PUBLISHED",
    "integration": {
      "id": "cm6s4uyou0001i2r47pxix6z1",
      "name": "Voholabs",
      "providerIdentifier": "linkedin-page",
      "picture": "https://example.com/avatar.jpg",
      "type": "social"
    }
  }
]

The request has the header Content-Type: application/json. Read the array rather than a single object, so your code also accepts the test payload.

How do I test it?#

In the webhook form, choose Send Test. Studio sends a sample array with two example posts, one for Instagram and one for Facebook, to the URL in the form. It uses the same shape as a real delivery, so your endpoint should accept both.

The test does not report your endpoint's answer. Check your endpoint's own logs, or point the URL at a request inspector while you build.

Are webhooks retried or signed?#

No to both:

• No retries. Studio sends each request once. If your endpoint is down, or answers with an error, the delivery is lost. To catch up, list recent posts with GET /posts on the public API.
• No signature. Requests carry no signing header. Use a long, hard-to-guess URL, and treat the payload as a hint: fetch the post through the API if you need to trust the details.