Creator OSDocs

Use case

React to events with webhooks

Works on: Events from every connected network

Get a POST the moment a post publishes or fails, a comment lands, or a DM arrives, instead of polling. See the Webhooks guide for the payload and signature verification.

  1. 1

    Register your endpoint and store the secret.

    POST/v1/webhooksCreate a webhook endpoint reference →
    curl -X POST "https://creatoros-production-5658.up.railway.app/v1/webhooks" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/creatoros/webhooks",
    "events": [
      "post.published",
      "post.failed",
      "comment.received",
      "message.received"
    ]
  }'
  2. 2

    Send yourself a test event.

    POST/v1/webhooks/{webhookId}/testSend a test event reference →
    curl -X POST "https://creatoros-production-5658.up.railway.app/v1/webhooks/9b1f6c2e-4d7a-4c8e-9f21-6a3b5d7e8c90/test" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

With the CLI

$ creatoros webhooks:create --url https://example.com/creatoros/webhooks --events post.published,comment.receivedCopy
$ creatoros webhooks:test <webhook_id>Copy

Or ask your agent

“Set up a webhook to my server for new comments and published posts.”

PreviousConnect social accountsNextWorkspace