Skip to main content
POST
/
v1
/
public
/
topics.subscribe
curl --location --request POST 'https://api.yourapp.com/v1/public/topics.subscribe' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "topic-uuid-123"
}'

{
  "data": {
    "topicSubscriber": {
      "id": "subscription-uuid",
      "topicId": "topic-uuid-123",
      "subscriberId": "sub-uuid-789",
      "createdAt": "2024-01-17T15:30:00Z"
    },
    "ok": true
  }
}

​
Authentication

Authorization: Bearer SUBSCRIBER_JWT_TOKEN

​
Request Body

​
id
string
required
Topic ID (UUID) to subscribe to

​
Response

​
data
object
Subscription result
curl --location --request POST 'https://api.yourapp.com/v1/public/topics.subscribe' \
--header 'Authorization: Bearer SUBSCRIBER_JWT_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id": "topic-uuid-123"
}'

{
  "data": {
    "topicSubscriber": {
      "id": "subscription-uuid",
      "topicId": "topic-uuid-123",
      "subscriberId": "sub-uuid-789",
      "createdAt": "2024-01-17T15:30:00Z"
    },
    "ok": true
  }
}

​
Behavior

  • Event Trigger: Fires topic-subscribers.create event
  • Team Validation: Subscriber must belong to same team
  • Idempotent: Safe to call multiple times

​
Notes

  • Triggers webhook event for integrations
  • Subscriber receives notifications for topic updates