API Reference

Follow an Account

Create a subscription or replace its content filters.

PUT/webhooks/{id}/subscriptions/{handle}

Parameters

The array replaces the previous selection. This does not follow the account on your personal profile or copy past content. The subscription stays bound to the account after handle changes.

idpath UUID, required: Republic registration ID.
handlepath string, required: Account handle without @; retained aliases are accepted.
content_typesbody string[], required: One or more: posts, replies, quotes, reposts, articles.

Request

cURL

curl -X PUT 'https://dev.republicrx.app/api/developer/v1/webhooks/WEBHOOK_ID/subscriptions/Safety' \
  -H "Authorization: Bearer $REPUBLIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content_types":["posts","quotes","articles"]}'

Response

HTTP 200 for both new subscriptions and filter updates.

json

{
  "data": {
    "ok": true
  }
}